Model#

Model commands are used to create Abaqus/CAE models. A finished model contains all the data that Abaqus/CAE needs to create and submit an analysis to Abaqus/Standard or Abaqus/Explicit. Models are stored in a model database.

Objects in Model

Create models#

class Mdb(pathName='')[source]

The Mdb object is the high-level Abaqus model database. A model database stores models and analysis controls.

Note

This object can be accessed by:

mdb

Note

Check Mdb on help.3ds.com/2021.

Public Data Attributes:

Inherited from MdbBase

version

An Int specifying the release number of the Mdb object in memory.

lastChangedCount

A Float specifying the value of a counter associated with the Mdb object.

jobs

A repository of Job objects.

adaptivityProcesses

A repository of AdaptivityProcess objects.

optimizationProcesses

A repository of OptimizationProcess objects.

meshEditOptions

A MeshEditOptions object specifying the undo/redo behavior when editing meshes on parts or part instances.

models

A repository of Model objects.

customData

A RepositorySupport object.

annotations

A repository of Annotation objects.

Public Methods:

Model(name[, description, stefanBoltzmann, ...])

This method creates a Model object.
Inherited from AcisMdb

openAcis(fileName[, scaleFromFile])

This method creates an AcisFile object from a file containing ACIS-format geometry.

openCatia(fileName[, topology, ...])

This method creates an AcisFile object from a file containing V5-format geometry.

openEnf(fileName, fileType[, topology, ...])

This method creates an AcisFile object from a file containing Elysium Neutral File-format geometry that was created by CATIA V5, I-DEAS, or Pro/ENGINEER.

openIges(fileName[, trimCurve, ...])

This method creates an AcisFile object from a file containing IGES-format geometry.

openParasolid(fileName[, topology])

This method creates an AcisFile object from a file containing Parasolid-format geometry.

openStep(fileName[, scale])

This method creates an AcisFile object from a file containing STEP-format geometry.

openVda(fileName)

This method creates an AcisFile object from a file containing VDA-FS-format geometry.

openSolidworks(fileName[, topology])

This method creates an AcisFile object from a file containing Solidworks format geometry.
Inherited from JobMdb

Job(name, model[, description, type, queue, ...])

This method creates an analysis job using a model on a model database (MDB) for the model definition.

JobFromInputFile(name, inputFileName[, ...])

This method creates an analysis job using an input file for the model definition.

OptimizationProcess(name, model, task, ...)

This method creates an OptimizationProcess object.
Inherited from MdbBase

__init__([pathName])

This constructor creates an empty Mdb object.

importDxf(fileName)

This method creates a ConstrainedSketch object from a file containing dxf-format (AutoCAD) geometry.

openMdb(pathName)

This method opens an existing model database file.

close()

This method closes an open Mdb object but does not save the Mdb object to disk.

save()

This method saves an Mdb object to disk at the location specified by pathName (pathName is a member of the Mdb object).

saveAs(pathName)

This method saves an Mdb object to disk at the specified location.

openAuxMdb(pathName)

This method opens an auxiliary Mdb object on the disk at the specified location.

closeAuxMdb()

This method closes the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

getAuxMdbModelNames()

This method returns a list of model names present in the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

copyAuxMdbModel(fromName[, toName])

This method copies a specified model from the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

Object features#

Model#

class Model(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]#

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

The corresponding analysis keywords are:

  • PHYSICAL CONSTANTS

Note

Check Model on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

Inherited from AdaptivityModel

adaptiveRemesh(odb)

This method remeshes the model using the active remesh rules in the model and the error indicator results from a previous analysis.

AdaptiveMeshConstraint(name, category, region)

The AdaptiveMeshConstraint object is the abstract base type for other Arbitrary Lagrangian Eularian (ALE) style AdaptiveMeshConstraint objects.

AdaptiveMeshControl(name[, remapping, ...])

This method creates an AdaptiveMeshControl object.

DisplacementAdaptiveMeshConstraint(name, ...)

This method creates a DisplacementAdaptiveMeshConstraint object.

RemeshingRule(name, stepName, variables[, ...])

This method creates a RemeshingRule object.

VelocityAdaptiveMeshConstraint(name, ...[, ...])

This method creates a VelocityAdaptiveMeshConstraint object.
Inherited from AmplitudeModel

ActuatorAmplitude(name[, timeSpan])

This method creates a ActuatorAmplitude object.

DecayAmplitude(name, initial, maximum, ...)

This method creates a DecayAmplitude object.

EquallySpacedAmplitude(name, fixedInterval, data)

This method creates an EquallySpacedAmplitude object.

ModulatedAmplitude(name, initial, magnitude, ...)

This method creates a ModulatedAmplitude object.

PeriodicAmplitude(name, frequency, start, ...)

This method creates a PeriodicAmplitude object.

PsdDefinition(name, data[, unitType, ...])

This method creates a PsdDefinition object.

SmoothStepAmplitude(name, data[, timeSpan])

This method creates a SmoothStepAmplitude object.

SolutionDependentAmplitude(name[, initial, ...])

This method creates a SolutionDependentAmplitude object.

SpectrumAmplitude(name, method, data[, ...])

This method creates a SpectrumAmplitude object.

TabularAmplitude(name, data[, smooth, timeSpan])

This method creates a TabularAmplitude object.
Inherited from AssemblyModel

Instance(name, objectToCopy)

This method copies a PartInstance object from the specified model and creates a new PartInstance object.

convertAllSketches([regenerate, ...])

This method converts all sketches from Abaqus 6.5 or earlier to the equivalent ConstrainedSketch objects.

linkInstances(instancesMap)

This method links the selected PartInstance objects to the corresponding PartInstance objects from the specified models.
Inherited from BoundaryConditionModel

AccelerationBaseMotionBC(name, ...[, ...])

This method creates a AccelerationBaseMotionBC object.

AccelerationBC(name, createStepName, region)

This method creates an AccelerationBC object.

AcousticPressureBC(name, createStepName, region)

This method creates a AcousticPressureBC object.

ConcentrationBC(name, createStepName, region)

This method creates a ConcentrationBC object.

ConnAccelerationBC(name, createStepName[, ...])

This method creates an ConnAccelerationBC object on a wire region.

ConnDisplacementBC(name, createStepName[, ...])

This method creates a ConnDisplacementBC object on a wire region.

ConnVelocityBC(name, createStepName[, ...])

This method creates a ConnVelocityBC object on a wire region.

DisplacementBaseMotionBC(name, ...[, ...])

This method creates a DisplacementBaseMotionBC object.

DisplacementBC(name, createStepName, region)

This method creates a DisplacementBC object.

ElectricPotentialBC(name, createStepName, region)

This method creates an ElectricPotentialBC object.

EulerianBC(name, createStepName, region[, ...])

This method creates a EulerianBC object.

EulerianMotionBC(name, createStepName, ...)

This method creates an EulerianMotionBC object.

FluidCavityPressureBC(name, createStepName, ...)

This method creates a FluidCavityPressureBC object.

MagneticVectorPotentialBC(name, ...[, ...])

This method creates a MagneticVectorPotentialBC object.

MaterialFlowBC(name, createStepName, region)

This method creates a MaterialFlowBC object.

PorePressureBC(name, createStepName, region)

This method creates a PorePressureBC object.

RetainedNodalDofsBC(name, createStepName, region)

This method creates a RetainedNodalDofsBC object.

SecondaryBaseBC(name, createStepName, ...)

This method creates a SecondaryBaseBC object.

SubmodelBC(name, createStepName, region, ...)

This method creates a SubmodelBC object.

TemperatureBC(name, createStepName, region)

This method creates a TemperatureBC object.

VelocityBaseMotionBC(name, createStepName, dof)

This method creates a VelocityBaseMotionBC object.

VelocityBC(name, createStepName, region[, ...])

This method creates a VelocityBC object.

EncastreBC(name, createStepName, region[, ...])

This method creates an encastre TypeBC object.

PinnedBC(name, createStepName, region[, ...])

This method creates a pinned TypeBC object.

XsymmBC(name, createStepName, region[, ...])

This method creates a TypeBC object that specifies symmetry about the X-axis.

YsymmBC(name, createStepName, region[, ...])

This method creates a TypeBC object that specifies symmetry about the Y-axis.

ZsymmBC(name, createStepName, region[, ...])

This method creates a TypeBC object that specifies symmetry about the Z-axis.

XasymmBC(name, createStepName, region[, ...])

This method creates a TypeBC object that specifies antisymmetry about the X-axis.

YasymmBC(name, createStepName, region[, ...])

This method creates a TypeBC object that specifies antisymmetry about the Y-axis.

ZasymmBC(name, createStepName, region[, ...])

This method creates a TypeBC object that specifies antisymmetry about the Z-axis.
Inherited from CalibrationModel

Calibration(name)

This method creates a Calibration object.
Inherited from ConstraintModel

AdjustPoints(name, surface, controlPoints)

This method creates an AdjustPoints object.

Coupling(name, surface, controlPoint, ...[, ...])

This method creates a Coupling object.

DisplayBody(name, instance, controlPoints)

This method creates a DisplayBody object.

EmbeddedRegion(name, embeddedRegion, hostRegion)

This method creates a EmbeddedRegion object.

Equation(name, terms)

This method creates an Equation object.

MultipointConstraint(name, surface, ...[, ...])

This method creates a MultipointConstraint object.

RigidBody(name, refPointRegion[, ...])

This method creates a RigidBody object.

ShellSolidCoupling(name, shellEdge, solidFace)

This method creates a ShellSolidCoupling object.

Tie(name, master, slave[, adjust, ...])

This method creates a Tie object.
Inherited from FilterModel

ButterworthFilter(name, cutoffFrequency[, ...])

This method creates a ButterworthFilter object.

Chebyshev1Filter(name, cutoffFrequency[, ...])

This method creates a Chebyshev1Filter object.

Chebyshev2Filter(name, cutoffFrequency[, ...])

This method creates a Chebyshev2Filter object.

OperatorFilter(name, cutoffFrequency[, ...])

This method creates an OperatorFilter object.
Inherited from InteractionModel

contactDetection([name, createStepName, ...])

This method uses contact detection to create SurfaceToSurfaceContactStd, SurfaceToSurfaceContactExp, and Tie objects.

getSurfaceSeparation()

This method returns a list of all possible contacts that can be created using the ContactDetection method.

AcousticImpedance(name, createStepName, surface)

This method creates an AcousticImpedance object.

ActuatorSensor(name, createStepName, point, ...)

This method creates an ActuatorSensor object.

CavityRadiation(name, createStepName, surfaces)

This method creates a CavityRadiation object.

ConcentratedFilmCondition(name, ...[, ...])

This method creates a ConcentratedFilmCondition object.

ConcentratedRadiationToAmbient(name, ...[, ...])

This method creates a ConcentratedRadiationToAmbient object.

ContactExp(name, createStepName[, ...])

This method creates a ContactExp object.

ContactStd(name, createStepName[, ...])

This method creates a ContactStd object.

CyclicSymmetry(name, createStepName, master, ...)

This method creates a CyclicSymmetry object.

ElasticFoundation(name, createStepName, ...)

This method creates an ElasticFoundation object.

FilmCondition(name, createStepName, surface, ...)

This method creates a FilmCondition object.

FluidCavity(name, createStepName, ...[, ...])

This method creates an FluidCavity object.

FluidExchange(name, createStepName, ...[, ...])

This method creates an FluidExchange object.

FluidInflator(name, createStepName, cavity, ...)

This method creates a FluidInflator object.

IncidentWave(name, createStepName, ...[, ...])

This method creates an IncidentWave object.

ModelChange(name, createStepName[, ...])

This method creates a ModelChange object.

PressurePenetration(name, createStepName, ...)

This method creates a PressurePenetration object.

RadiationToAmbient(name, createStepName, ...)

This method creates a RadiationToAmbient object.

SelfContactExp(name, createStepName, ...[, ...])

This method creates a SelfContactExp object.

SelfContactStd(name, createStepName, ...[, ...])

This method creates a SelfContactStd object.

StdXplCosimulation(name, createStepName, region)

This method creates a StdXplCosimulation object.

SurfaceToSurfaceContactExp(name, ...[, ...])

This method creates a SurfaceToSurfaceContactExp object.

SurfaceToSurfaceContactStd(name, ...[, ...])

This method creates a SurfaceToSurfaceContactStd object.

XFEMCrackGrowth(name, createStepName, crackName)

This method creates an XFEMCrackGrowth object.
Inherited from InteractionContactControlModel

ExpContactControl(name[, globTrkChoice, ...])

This method creates an ExpContactControl object.

StdContactControl(name[, ...])

This method creates an StdContactControl object.
Inherited from InteractionContactInitializationModel

ExpInitialization(name[, overclosureType, ...])

This method creates an ExpInitialization object.

StdInitialization(name[, overclosureType, ...])

This method creates a StdInitialization object.
Inherited from InteractionContactStabilizationModel

StdStabilization(name[, zeroDistance, ...])

This method creates a StdStabilization object.
Inherited from InteractionPropertyModel

AcousticImpedanceProp(name, tableType, table)

This method creates an AcousticImpedanceProp object.

ActuatorSensorProp(name[, realProperties, ...])

This method creates an ActuatorSensorProp object.

CavityRadiationProp(name[, ...])

This method creates a CavityRadiationProp object.

ContactProperty(name)

This method creates a ContactProperty object.

FilmConditionProp(name[, ...])

This method creates a FilmConditionProp object.

FluidCavityProperty(name[, definition, ...])

This method creates a FluidCavityProperty object.

FluidExchangeProperty(name, dataTable[, ...])

This method creates a FluidExchangeProperty object.

FluidInflatorProperty(name, definition, ...)

This method creates a FluidInflatorProperty object.

IncidentWaveProperty(name[, definition, ...])

This method creates an IncidentWaveProperty object.
Inherited from LoadModel

BodyCharge(name, createStepName, region, ...)

This method creates a BodyCharge object.

BodyConcentrationFlux(name, createStepName, ...)

This method creates a BodyConcentrationFlux object.

BodyCurrent(name, createStepName, region, ...)

This method creates a BodyCurrent object.

BodyCurrentDensity(name, createStepName, ...)

This method creates a BodyCurrentDensity object.

BodyForce(name, createStepName, region[, ...])

This method creates a BodyForce object.

BodyHeatFlux(name, createStepName, region, ...)

This method creates a BodyHeatFlux object.

BoltLoad(name, createStepName, region, ...)

This method creates a BoltLoad object.

ConcCharge(name, createStepName, region, ...)

This method creates a ConcCharge object.

ConcConcFlux(name, createStepName, region, ...)

This method creates a ConcConcFlux object.

ConcCurrent(name, createStepName, region, ...)

This method creates a ConcCurrent object.

ConcentratedForce(name, createStepName, region)

This method creates a ConcentratedForce object.

ConcentratedHeatFlux(name, createStepName, ...)

This method creates a ConcentratedHeatFlux object.

ConcPoreFluid(name, createStepName, region, ...)

This method creates a ConcPoreFluid object.

ConnectorForce(name, createStepName[, ...])

This method creates a ConnectorForce object on a wire region.

ConnectorMoment(name, createStepName[, ...])

This method creates a ConnectorMoment object on a wire region.

CoriolisForce(name, createStepName, region, ...)

This method creates a CoriolisForce object.

Gravity(name, createStepName[, ...])

This method creates a Gravity object.

InertiaRelief(name, createStepName[, u1, ...])

This method creates an InertiaRelief object.

InwardVolAccel(name, createStepName, region, ...)

This method creates a InwardVolAccel object.

LineLoad(name, createStepName, region[, ...])

This method creates a LineLoad object.

Moment(name, createStepName, region[, cm1, ...])

This method creates a Moment object.

PEGLoad(name, createStepName, region[, ...])

This method creates a PEGLoad object.

PipePressure(name, createStepName, region, ...)

This method creates a Pressure object.

Pressure(name, createStepName, region[, ...])

This method creates a Pressure object.

RotationalBodyForce(name, createStepName, ...)

This method creates a RotationalBodyForce object.

ShellEdgeLoad(name, createStepName, region, ...)

This method creates a ShellEdgeLoad object.

SubmodelSB(name, createStepName, region, ...)

This method creates a SubmodelSB object.

SubstructureLoad(name, createStepName, ...)

This method creates a SubstructureLoad object.

SurfaceCharge(name, createStepName, region, ...)

This method creates a SurfaceCharge object.

SurfaceConcentrationFlux(name, ...[, field, ...])

This method creates a SurfaceConcentrationFlux object.

SurfaceCurrent(name, createStepName, region, ...)

This method creates a SurfaceCurrent object.

SurfaceCurrentDensity(name, createStepName, ...)

This method creates a SurfaceCurrentDensity object.

SurfaceHeatFlux(name, createStepName, ...[, ...])

This method creates a SurfaceHeatFlux object.

SurfacePoreFluid(name, createStepName, ...)

This method creates a SurfacePoreFluid object.

SurfaceTraction(name, createStepName, ...[, ...])

This method creates a SurfaceTraction object.
Inherited from MaterialModel

Material(name[, description, materialIdentifier])

This method creates a Material object.
Inherited from OptimizationTaskModel

BeadTask(name[, abaqusSensitivities, ...])

This method creates a BeadTask object.

ShapeTask(name[, abaqusSensitivities, ...])

This method creates a ShapeTask object.

SizingTask(name[, abaqusSensitivities, ...])

This method creates a SizingTask object.

TopologyTask(name[, abaqusSensitivities, ...])

This method creates a TopologyTask object.
Inherited from PartModel

Part(name, dimensionality, type[, twist])

This method creates a Part object and places it in the parts repository.
Inherited from PredefinedFieldModel

FluidCavityPressure(name, fluidCavity, ...)

This method creates a FluidCavityPressure object.

InitialState(name, instances, fileName[, ...])

This method creates an InitialState predefined field object.

KinematicHardening(name, region[, ...])

This method creates a KinematicHardening object.

MaterialAssignment(name, instanceList[, ...])

This method creates a MaterialAssignment predefined field object.

Temperature(name, createStepName, region[, ...])

This method creates a Temperature object.

Velocity(name, region, velocity1, velocity2, ...)

This method creates a Velocity predefined field object.

Stress(name, region[, distributionType, ...])

This method creates a Stress predefined field object.

Field(name, createStepName, region[, ...])

This method creates a Field object.
Inherited from BeamSectionProfileModel

beamProfilesFromOdb(fileName)

This method creates Profile objects by reading an output database.

ArbitraryProfile(name, table)

This method creates a ArbitraryProfile object.

BoxProfile(name, a, b, uniformThickness, t1)

This method creates a BoxProfile object.

CircularProfile(name, r)

This method creates a CircularProfile object.

GeneralizedProfile(name, area, i11, i12, ...)

This method creates a GeneralizedProfile object.

HexagonalProfile(name, r, t)

This method creates a HexagonalProfile object.

IProfile(name, l, h, b1, b2, t1, t2, t3)

This method creates an IProfile object.

LProfile(name, a, b, t1, t2)

This method creates a LProfile object.

PipeProfile(name, r, t)

This method creates a PipeProfile object.

RectangularProfile(name, a, b)

This method creates a RectangularProfile object.

TProfile(name, b, h, l, tf, tw)

This method creates a TProfile object.

TrapezoidalProfile(name, a, b, c, d)

This method creates a TrapezoidalProfile object.
Inherited from OutputModel

FieldOutputRequest(name, createStepName[, ...])

This method creates a FieldOutputRequest object.

HistoryOutputRequest(name, createStepName[, ...])

This method creates a HistoryOutputRequest object.

IntegratedOutputSection(name, surface[, ...])

This method creates an IntegratedOutputSection object.

TimePoint(name, points)

This method creates a TimePoint object.
Inherited from SectionModel

AcousticInfiniteSection(name, material[, ...])

This method creates an AcousticInfiniteSection object.

AcousticInterfaceSection(name[, thickness])

This method creates an AcousticInterfaceSection object.

BeamSection(name, integration, profile[, ...])

This method creates a BeamSection object.

CohesiveSection(name, response, material[, ...])

This method creates a CohesiveSection object.

CompositeShellSection(name, layup[, ...])

This method creates a CompositeShellSection object.

CompositeSolidSection(name, layup[, ...])

This method creates a CompositeSolidSection object.

ConnectorSection(name[, assembledType, ...])

This method creates a ConnectorSection object.

EulerianSection(name, data)

This method creates a EulerianSection object.

GasketSection(name, material[, ...])

This method creates a GasketSection object.

GeneralStiffnessSection(name, stiffnessMatrix)

This method creates a GeneralStiffnessSection object.

HomogeneousShellSection(name, material[, ...])

This method creates a HomogeneousShellSection object.

HomogeneousSolidSection(name, material[, ...])

This method creates a HomogeneousSolidSection object.

MembraneSection(name, material[, thickness, ...])

This method creates a MembraneSection object.

MPCSection(name, mpcType[, userMode, userType])

This method creates a MPCSection object.

PEGSection(name, material[, thickness, ...])

This method creates a PEGSection object.

SurfaceSection(name[, useDensity, density])

This method creates a SurfaceSection object.

TrussSection(name, material[, area])

This method creates a TrussSection object.
Inherited from SketchModel

ConstrainedSketch(name, sheetSize[, ...])

This method creates a ConstrainedSketch object.
Inherited from StepModel

AnnealStep(name, previous[, description, ...])

This method creates an AnnealStep object.

BuckleStep(name, previous, numEigen[, ...])

This method creates a BuckleStep object.

ComplexFrequencyStep(name, previous[, ...])

This method creates a ComplexFrequencyStep object.

CoupledTempDisplacementStep(name, previous)

This method creates a CoupledTempDisplacementStep object.

CoupledThermalElectricalStructuralStep(name, ...)

This method creates a CoupledThermalElectricalStructuralStep object.

CoupledThermalElectricStep(name, previous[, ...])

This method creates a CoupledThermalElectricStep object.

DirectCyclicStep(name, previous[, ...])

This method creates a DirectCyclicStep object.

EmagTimeHarmonicStep(name, previous, ...[, ...])

This method creates a EmagTimeHarmonicStep object.

ExplicitDynamicsStep(name, previous[, ...])

This method creates an ExplicitDynamicsStep object.

FrequencyStep(name, previous, eigensolver[, ...])

This method creates a FrequencyStep object.

GeostaticStep(name, previous[, description, ...])

This method creates a GeostaticStep object.

HeatTransferStep(name, previous[, ...])

This method creates a HeatTransferStep object.

ImplicitDynamicsStep(name, previous[, ...])

This method creates an ImplicitDynamicsStep object.

MassDiffusionStep(name, previous[, ...])

This method creates a MassDiffusionStep object.

ModalDynamicsStep(name, previous[, ...])

This method creates a ModalDynamicsStep object.

RandomResponseStep(name, previous, freq[, ...])

This method creates a RandomResponseStep object.

ResponseSpectrumStep(name, previous, components)

This method creates a ResponseSpectrumStep object.

SoilsStep(name, previous[, description, ...])

This method creates a SoilsStep object.

StaticLinearPerturbationStep(name, previous)

This method creates a StaticLinearPerturbationStep object.

StaticRiksStep(name, previous[, ...])

This method creates a StaticRiksStep object.

StaticStep(name, previous[, description, ...])

This method creates a StaticStep object.

SteadyStateDirectStep(name, previous, ...[, ...])

This method creates a SteadyStateDirectStep object.

SteadyStateModalStep(name, previous, ...[, ...])

This method creates a SteadyStateModalStep object.

SteadyStateSubspaceStep(name, previous, ...)

This method creates a SteadyStateSubspaceStep object.

SubspaceDynamicsStep(name, previous[, ...])

This method creates a SubspaceDynamicsStep object.

SubstructureGenerateStep(name, previous, ...)

This method creates a SubstructureGenerateStep object.

TempDisplacementDynamicsStep(name, previous)

This method creates a TempDisplacementDynamicsStep object.

ViscoStep(name, previous[, description, ...])

This method creates a ViscoStep object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
AccelerationBC(name, createStepName, region, fieldName='', a1=abaqusConstants.UNSET, a2=abaqusConstants.UNSET, a3=abaqusConstants.UNSET, ar1=abaqusConstants.UNSET, ar2=abaqusConstants.UNSET, ar3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, localCsys=None, distributionType=abaqusConstants.UNIFORM)[source]#

This method creates an AccelerationBC object.

Note

This function can be accessed by:

mdb.models[name].AccelerationBC

Note

Check AccelerationBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • a1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the acceleration component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.Note:Although a1, a2, a3, ar1, ar2, and ar3 are optional arguments, at least one of them must be specified.

  • a2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the acceleration component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • a3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the acceleration component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ar1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational acceleration component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ar2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational acceleration component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ar3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational acceleration component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

Returns:

bc – An AccelerationBC object.

Return type:

AccelerationBC

AccelerationBaseMotionBC(name, createStepName, dof, amplitudeScaleFactor=1, centerOfRotation=(), correlation=None, secondaryBase='', useComplex=OFF, amplitude=abaqusConstants.UNSET)[source]#

This method creates a AccelerationBaseMotionBC object.

Note

This function can be accessed by:

mdb.models[name].AccelerationBaseMotionBC

Note

Check AccelerationBaseMotionBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • dof (SymbolicConstant) – A SymbolicConstant specifying the constrained degree-of-freedom. Possible values for the SymbolicConstant are U1, U2, U3, UR1, UR2, UR3. The default value is U1.

  • amplitudeScaleFactor (float, default: 1) – A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

  • centerOfRotation (tuple, default: ()) – A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

  • correlation (Optional[Correlation], default: None) – A Correlation object.

  • secondaryBase (str, default: '') – A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

  • useComplex (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

bc – An AccelerationBaseMotionBC object.

Return type:

AccelerationBaseMotionBC

AcousticImpedance(name, createStepName, surface, definition=abaqusConstants.TABULAR, interactionProperty='', nonreflectingType=abaqusConstants.PLANE, radius=1, semimajorAxis=1, eccentricity=0, centerCoordinates=(), directionCosine=())[source]#

This method creates an AcousticImpedance object.

Note

This function can be accessed by:

mdb.models[name].AcousticImpedance

Note

Check AcousticImpedance on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the AcousticImpedance object is created.

  • surface (Region) – A Region object specifying the acoustic boundary surface.

  • definition (SymbolicConstant, default: TABULAR) – A SymbolicConstant specifying the type of acoustic impedance to be defined. Possible values are TABULAR and NONREFLECTING. The default value is TABULAR.

  • interactionProperty (str, default: '') – A String specifying the AcousticImpedanceProp object associated with this interaction.

  • nonreflectingType (SymbolicConstant, default: PLANE) – A SymbolicConstant specifying the type of nonreflecting geometry to be defined. Possible values are PLANE, IMPROVED, CIRCULAR, SPHERICAL, ELLIPTICAL, and PROLATE. The default value is PLANE.This argument is valid only when definition = NONREFLECTING.

  • radius (float, default: 1) – A Float specifying the radius of the circle or sphere defining the boundary surface. The default value is 1.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = CIRCULAR or SPHERICAL.

  • semimajorAxis (float, default: 1) – A Float specifying the semimajor axis length of the ellipse or prolate spheroid defining the boundary surface. The default value is 1.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.

  • eccentricity (float, default: 0) – A Float specifying the eccentricity of the ellipse or prolate spheroid defining the boundary surface. The default value is 0.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.

  • centerCoordinates (tuple, default: ()) – A sequence of three Floats specifying the X, Y, and Z coordinates of the center of the ellipse or prolate spheroid defining the boundary surface. The default value is (0, 0, 0).This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.

  • directionCosine (tuple, default: ()) – A sequence of three Floats specifying the X, Y, and Z components of the direction cosine of the major axis of the ellipse or prolate spheroid defining the boundary surface. The default value is (0, 0, 1).This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.

Returns:

An AcousticImpedance object.

Return type:

AcousticImpedance

AcousticImpedanceProp(name, tableType, table, frequencyDependency=OFF)[source]#

This method creates an AcousticImpedanceProp object.

Note

This function can be accessed by:

mdb.models[name].AcousticImpedanceProp

Note

Check AcousticImpedanceProp on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • tableType (SymbolicConstant) – A SymbolicConstant specifying the type of tabular data to be defined. Possible values are IMPEDANCE and ADMITTANCE.

  • table (tuple) – A sequence of sequences of Floats specifying acoustic impedance properties.If tableType = IMPEDANCE, each sequence of the table data specifies:The real part of the complex impedance.The imaginary part of the complex impedance.Frequency, if the data depend on frequency.If tableType = ADMITTANCE, each sequence of the table data specifies:The real part of the complex admittance.The imaginary part of the complex admittance.Frequency, if the data depend on frequency.

  • frequencyDependency (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the table data depend on frequency. The default value is OFF.

Returns:

An AcousticImpedanceProp object.

Return type:

AcousticImpedanceProp

AcousticInfiniteSection(name, material, thickness=1, order=10)[source]#

This method creates an AcousticInfiniteSection object.

Note

This function can be accessed by:

mdb.models[name].AcousticInfiniteSection
session.odbs[name].AcousticInfiniteSection

Note

Check AcousticInfiniteSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • material (str) – A String specifying the name of the material.

  • thickness (float, default: 1) – A Float specifying the thickness of the section. Possible values are thickness >> 0.0. The default value is 1.0.

  • order (int, default: 10) – An Int specifying the number of ninth-order polynomials that will be used to resolve the variation of the acoustic field in the infinite direction. Possible values are 0 << order ≤ 10. The default value is 10.

Returns:

An AcousticInfiniteSection object.

Return type:

AcousticInfiniteSection

Raises:

  • InvalidNameError –

  • RangeError –

AcousticInterfaceSection(name, thickness=1)[source]#

This method creates an AcousticInterfaceSection object.

Note

This function can be accessed by:

mdb.models[name].AcousticInterfaceSection
session.odbs[name].AcousticInterfaceSection

Note

Check AcousticInterfaceSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • thickness (float, default: 1) – A Float specifying the thickness of the section. Possible values are thickness >> 0.0. The default value is 1.0.

Returns:

An AcousticInterfaceSection object.

Return type:

AcousticInterfaceSection

Raises:

  • InvalidNameError –

  • RangeError –

AcousticPressureBC(name, createStepName, region, fieldName='', magnitude=0, distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET, fixed=OFF)[source]#

This method creates a AcousticPressureBC object.

Note

This function can be accessed by:

mdb.models[name].AcousticPressureBC

Note

Check AcousticPressureBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • magnitude (float, default: 0) – A Float specifying the acoustic pressure magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – An AcousticPressureBC object.

Return type:

AcousticPressureBC

ActuatorAmplitude(name, timeSpan=abaqusConstants.STEP)[source]#

This method creates a ActuatorAmplitude object.

Note

This function can be accessed by:

mdb.models[name].ActuatorAmplitude
session.odbs[name].ActuatorAmplitude

Note

Check ActuatorAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

An ActuatorAmplitude object.

Return type:

ActuatorAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

ActuatorSensor(name, createStepName, point, interactionProperty, noCoordComponents, unsymm, noSolutionDepVar, userSubUel, dof, solutionDepVars)[source]#

This method creates an ActuatorSensor object.

Note

This function can be accessed by:

mdb.models[name].ActuatorSensor

Note

Check ActuatorSensor on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the actuator/sensor interaction is created. createStepName must be set to ‘Initial’.

  • point (Region) – A Region object specifying the point at which the constraint is applied.

  • interactionProperty (str) – A String specifying the ActuatorSensorProp object associated with this interaction.

  • noCoordComponents (int) – An Int specifying the number of coordinate components supplied to the user subroutine (UEL).

  • unsymm (Union[AbaqusBoolean, bool]) – A Boolean specifying whether the element matrices are symmetric (ON) or unsymmetric (OFF). The default value is OFF.

  • noSolutionDepVar (int) – An Int specifying the number of solution-dependent variables. The default value is 0.

  • userSubUel (str) – A String specifying the name of the user subroutine (UEL) that defines the user element.

  • dof (str) – A String specifying the degrees of freedom, separated by commas.

  • solutionDepVars (tuple) – A sequence of Floats specifying the initial values of the solution-dependent variables.

Returns:

An ActuatorSensor object.

Return type:

ActuatorSensor

ActuatorSensorProp(name, realProperties=(), integerProperties=())[source]#

This method creates an ActuatorSensorProp object.

Note

This function can be accessed by:

mdb.models[name].ActuatorSensorProp

Note

Check ActuatorSensorProp on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • realProperties (tuple, default: ()) – A sequence of Floats specifying the PROPS array used by user subroutine UEL. The default value is an empty sequence.

  • integerProperties (tuple, default: ()) – A sequence of Ints specifying the JPROPS array used by user subroutine UEL. The default value is an empty sequence.

Returns:

An ActuatorSensorProp object.

Return type:

ActuatorSensorProp

AdaptiveMeshConstraint(name, category, region, localCsys=None)[source]#

The AdaptiveMeshConstraint object is the abstract base type for other Arbitrary Lagrangian Eularian (ALE) style AdaptiveMeshConstraint objects. The AdaptiveMeshConstraint object has no explicit constructor. The methods and members of the AdaptiveMeshConstraint object are common to all objects derived from the AdaptiveMeshConstraint object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

Check AdaptiveMeshConstraint on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the adaptive mesh constraint repository key.

  • category (SymbolicConstant) – A SymbolicConstant specifying the category of the adaptive mesh constraint. Possible values are MECHANICAL and THERMAL.

  • region (Region) – A Region object specifying the region to which the adaptive mesh constraint is applied.

  • localCsys (Optional[DatumCsys], default: None) – None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

An AdaptiveMeshConstraint object

Return type:

AdaptiveMeshConstraint

AdaptiveMeshControl(name, remapping=abaqusConstants.SECOND_ORDER_ADVECTION, smoothingAlgorithm=abaqusConstants.GEOMETRY_ENHANCED, smoothingPriority=abaqusConstants.UNIFORM, initialFeatureAngle=30, transitionFeatureAngle=30, momentumAdvection=abaqusConstants.ELEMENT_CENTER_PROJECTION, meshingPredictor=abaqusConstants.CURRENT, curvatureRefinement=1, volumetricSmoothingWeight=1, laplacianSmoothingWeight=0, equipotentialSmoothingWeight=0, meshConstraintAngle=60, originalConfigurationProjectionWeight=1, standardVolumetricSmoothingWeight=0)[source]#

This method creates an AdaptiveMeshControl object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

Check AdaptiveMeshControl on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the name of the object.

  • remapping (SymbolicConstant, default: SECOND_ORDER_ADVECTION) – A SymbolicConstant specifying the remapping algorithm. Possible values are FIRST_ORDER_ADVECTION and SECOND_ORDER_ADVECTION. The default value is SECOND_ORDER_ADVECTION.

  • smoothingAlgorithm (SymbolicConstant, default: GEOMETRY_ENHANCED) – A SymbolicConstant specifying the type of smoothing algorithm to use. Possible values are STANDARD and GEOMETRY_ENHANCED. The default value is GEOMETRY_ENHANCED.

  • smoothingPriority (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying the type of smoothing to perform. Possible values are UNIFORM and GRADED. The default value is UNIFORM.

  • initialFeatureAngle (float, default: 30) – A Float specifying the initial geometric feature angle, θI, in degrees. Possible values are 0° ≤θI≤ 180°. The default value is 30.0.

  • transitionFeatureAngle (float, default: 30) – A Float specifying the transitional feature angle, θT, in degrees. Possible values are 0° ≤θT≤ 180°. The default value is 30.0.

  • momentumAdvection (SymbolicConstant, default: ELEMENT_CENTER_PROJECTION) – A SymbolicConstant specifying the type of momentum advection algorithm. Possible values are ELEMENT_CENTER_PROJECTION and HALF_INDEX_SHIFT. The default value is ELEMENT_CENTER_PROJECTION.

  • meshingPredictor (SymbolicConstant, default: CURRENT) – A SymbolicConstant specifying the nodal starting location to use for remeshing. Possible values are CURRENT and PREVIOUS. The default value is CURRENT.

  • curvatureRefinement (float, default: 1) – A Float specifying the solution dependence weight, αC. Possible values are 0.0 ≤αC≤ 1.0. The default value is 1.0.

  • volumetricSmoothingWeight (float, default: 1) – A Float specifying the weight used by Abaqus/Explicit for the volumetric smoothing method. The default value is 1.0.

  • laplacianSmoothingWeight (float, default: 0) – A Float specifying the weight for the Laplacian smoothing method. The default value is 0.0.

  • equipotentialSmoothingWeight (float, default: 0) – A Float specifying the weight for the equipotential smoothing method. The default value is 0.0.

  • meshConstraintAngle (float, default: 60) – A Float specifying the initial geometric feature angle, θC. Possible values are 0° ≤θC≤ 180°. The default value is 60.0.

  • originalConfigurationProjectionWeight (float, default: 1) – A Float specifying the weight for the original configuration projection method. The default value is 1.0.

  • standardVolumetricSmoothingWeight (float, default: 0) – A Float specifying the weight used by Abaqus/Standard for the volumetric smoothing method. The default value is 0.0.

Returns:

An AdaptiveMeshControl object

Return type:

AdaptiveMeshControl

AdjustPoints(name, surface, controlPoints)[source]#

This method creates an AdjustPoints object.

Note

This function can be accessed by:

mdb.models[name].AdjustPoints

Note

Check AdjustPoints on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • surface (Region) – A Region object specifying the surface to which the controlPoints are adjusted.

  • controlPoints (Region) – A Region object specifying the constraint control points.

Returns:

An AdjustPoints object.

Return type:

AdjustPoints

AnnealStep(name, previous, description='', refTemp=None, maintainAttributes=False)[source]#

This method creates an AnnealStep object.

Note

This function can be accessed by:

mdb.models[name].AnnealStep

Note

Check AnnealStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • refTemp (Optional[float], default: None) – A Float specifying the post-anneal reference temperature. The default value is the current temperature at all nodes in the model after the annealing has completed.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

Returns:

step – An AnnealStep object.

Return type:

AnnealStep

ArbitraryProfile(name, table)[source]#

This method creates a ArbitraryProfile object.

Note

This function can be accessed by:

mdb.models[name].ArbitraryProfile
session.odbs[name].ArbitraryProfile

Note

Check ArbitraryProfile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • table (tuple) – A sequence of sequences of Floats specifying the items described below.

Returns:

An ArbitraryProfile object.

Return type:

ArbitraryProfile

Raises:

RangeError –

BeadTask(name, abaqusSensitivities=True, algorithm=abaqusConstants.GENERAL_OPTIMIZATION, areBCRegionsFrozen=OFF, beadIter=1, beadMaxMembraneStress=0, beadMinStress=0, beadPerturbation=0, beadWidth=abaqusConstants.DEFAULT, curveSmooth=5, filterRadius=4, filterRadiusBy=abaqusConstants.VALUE, flipNormalDir=OFF, frozenBoundaryConditionRegion=abaqusConstants.MODEL, isSensCalcOnlyOnDesignNodes=OFF, modeTrackingRegion=abaqusConstants.MODEL, nodalMoveLimit=0, nodeSmooth=abaqusConstants.DEFAULT, nodeUpdateStrategy=abaqusConstants.CONSERVATIVE, numTrackedModes=5, updateShapeBasisVectors=abaqusConstants.EVERY_CYCLE)[source]#

This method creates a BeadTask object.

Note

This function can be accessed by:

mdb.models[name].BeadTask

Note

Check BeadTask on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the optimization task repository key.

  • abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –

    A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

    New in version 2019: The abaqusSensitivities argument was added.

  • algorithm (SymbolicConstant, default: GENERAL_OPTIMIZATION) – A SymbolicConstant specifying the optimization task algorithm. Possible values are GENERAL_OPTIMIZATION and CONDITION_BASED_OPTIMIZATION. The default value is GENERAL_OPTIMIZATION.

  • areBCRegionsFrozen (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

  • beadIter (str, default: 1) – An int specifying the step size of the optimization. The default value is 1.

  • beadMaxMembraneStress (str, default: 0) – A float specifying maximum membrane/bending stress. The default value is 0.1.

  • beadMinStress (str, default: 0) – A float specifying minimum stress. The default value is 0.001.

  • beadPerturbation (str, default: 0) – A Sets perturbation size for finite differences. The default value is 0.0001.

  • beadWidth (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the Optimization product default or a float specifying the bead width. The default value is DEFAULT.

  • curveSmooth (str, default: 5) – A float specifying relative value to the middle element edge length such that normals in this area do not cross each other. The default value is 5.

  • filterRadius (str, default: 4) – A float specifying the filter radius. The default value is 4.

  • filterRadiusBy (SymbolicConstant, default: VALUE) – A SymbolicConstant specifying the method used to define filter radius. Possible values are VALUE and REFERENCE. The default is VALUE.

  • flipNormalDir (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the growth direction is along the normal direction of elements or opposite to the normal direction. The default value is OFF

  • frozenBoundaryConditionRegion (SymbolicConstant, default: MODEL) – When nodes with boundary conditions are excluded from the optimization (frozenBoundaryConditionRegions = ON). you can specify that this exclusion apply to nodes throughout the model or only to those nodes from a specific region. Set this parameter to the SymbolicConstant MODEL to apply the freeze to the entire model, or set this parameter to a Region object to specify an individual region over which nodes with boundary conditions should be frozen. The default value is MODEL.

  • isSensCalcOnlyOnDesignNodes (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to calculate the sensitivities only on design nodes or the whole model. The default value is ON

  • modeTrackingRegion (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

  • nodalMoveLimit (float, default: 0) – A Float specifying the maximum change in nodal displacement per design cycle. The default value is 0.1.

  • nodeSmooth (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the Optimization product default or a float specifying the node smooth. The default value is DEFAULT.

  • nodeUpdateStrategy (SymbolicConstant, default: CONSERVATIVE) – A SymbolicConstant specifying the strategy for how the nodal displacements are updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is CONSERVATIVE.

  • numTrackedModes (int, default: 5) – An Int specifying the number of modes included in mode tracking. The default value is 5.

  • updateShapeBasisVectors (SymbolicConstant, default: EVERY_CYCLE) – A SymbolicConstant specifying whether to update shape basis vectors in the first design cycle or every design cycle. Possible values are EVERY_CYCLE and FIRST_CYCLE. The default value is EVERY_CYCLE.

Returns:

A BeadTask object.

Return type:

BeadTask

BeamSection(name, integration, profile, poissonRatio=0, thermalExpansion=OFF, temperatureDependency=OFF, dependencies=0, density=None, referenceTemperature=None, temperatureVar=abaqusConstants.LINEAR, alphaDamping=0, betaDamping=0, compositeDamping=0, useFluidInertia=OFF, submerged=abaqusConstants.FULLY, fluidMassDensity=None, crossSectionRadius=None, lateralMassCoef=1, axialMassCoef=0, massOffsetX=0, massOffsetY=0, beamShape=abaqusConstants.CONSTANT, material='', table=(), outputPts=(), centroid=(0.0, 0.0), shearCenter=(0.0, 0.0), profileEnd='')[source]#

This method creates a BeamSection object.

Note

This function can be accessed by:

mdb.models[name].BeamSection
session.odbs[name].BeamSection

Note

Check BeamSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • integration (Literal[BEFORE_ANALYSIS, DURING_ANALYSIS]) – A SymbolicConstant specifying the integration method for the section. Possible values are BEFORE_ANALYSIS and DURING_ANALYSIS.

  • profile (str) – A String specifying the name of the profile. This argument represents the start profile in case of beamShape = TAPERED.

  • poissonRatio (float, default: 0) – A Float specifying the Poisson’s ratio of the section. The default value is 0.0.

  • thermalExpansion (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to use thermal expansion data. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • density (Optional[float], default: None) – None or a Float specifying the density of the section. The default value is None.

  • referenceTemperature (Optional[float], default: None) – None or a Float specifying the reference temperature of the section. The default value is None.

  • temperatureVar (Literal[LINEAR, INTERPOLATED], default: LINEAR) – A SymbolicConstant specifying the temperature variation for the section. Possible values are LINEAR and INTERPOLATED. The default value is LINEAR.

  • alphaDamping (float, default: 0) – A Float specifying the αRαR factor to create mass proportional damping in direct-integration dynamics. The default value is 0.0.

  • betaDamping (float, default: 0) – A Float specifying the βRβR factor to create stiffness proportional damping in direct-integration dynamics. The default value is 0.0.

  • compositeDamping (float, default: 0) – A Float specifying the fraction of critical damping to be used in calculating composite damping factors for the modes (for use in modal dynamics). The default value is 0.0.

  • useFluidInertia (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether added mass effects will be simulated. The default value is OFF.

  • submerged (Literal[FULLY, HALF], default: FULLY) – A SymbolicConstant specifying whether the section is either full submerged or half submerged. This argument applies only when useFluidInertia = True. Possible values are FULLY and HALF. The default value is FULLY.

  • fluidMassDensity (Optional[float], default: None) – None or a Float specifying the mass density of the fluid. This argument applies only when useFluidInertia = True and must be specified in that case. The default value is None.

  • crossSectionRadius (Optional[float], default: None) – None or a Float specifying the radius of the cylindrical cross-section. This argument applies only when useFluidInertia = True and must be specified in that case. The default value is None.

  • lateralMassCoef (float, default: 1) – A Float specifying the added mass coefficient, CACA, for lateral motions of the beam. This argument applies only when*useFluidInertia* = True. The default value is 1.0.

  • axialMassCoef (float, default: 0) – A Float specifying the added mass coefficient, C(A−E)C(A-E), for motions along the axis of the beam. This argument affects only the term added to the free end(s) of the beam, and applies only when useFluidInertia = True. The default value is 0.0.

  • massOffsetX (float, default: 0) – A Float specifying the local 1-coordinate of the center of the cylindrical cross-section with respect to the beam cross-section. This argument applies only when useFluidInertia = True. The default value is 0.0.

  • massOffsetY (float, default: 0) – A Float specifying the local 2-coordinate of the center of the cylindrical cross-section with respect to the beam cross-section. This argument applies only when useFluidInertia = True. The default value is 0.0.

  • beamShape (Literal[CONSTANT, TAPERED], default: CONSTANT) – A SymbolicConstant specifying the change in cross-section of the beam along length. Possible values are CONSTANT and TAPERED. The default value is CONSTANT. This parameter is available for manipulating the model database but not for the ODB API.

  • material (str, default: '') – A String specifying the name of the material. The default value is an empty string. The material is required when integration is “DURING_ANALYSIS”.

  • table (tuple, default: ()) – A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.

  • outputPts (tuple, default: ()) – A sequence of pairs of Floats specifying the positions at which output is requested. The default value is an empty sequence.

  • centroid (Tuple[float, float], default: (0.0, 0.0)) – A pair of Floats specifying the X - Y coordinates of the centroid. The default value is (0.0, 0.0).

  • shearCenter (Tuple[float, float], default: (0.0, 0.0)) – A pair of Floats specifying the X - Y coordinates of the shear center. The default value is (0.0, 0.0).

  • profileEnd (str, default: '') – A String specifying the name of the end profile. The type of the end profile must be same as that of the start profile. This argument is valid only when beamShape = TAPERED. The default value is an empty string. This parameter is available for manipulating the model database but not for the ODB API.

Returns:

A BeamSection object.

Return type:

BeamSection

BodyCharge(name, createStepName, region, magnitude, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, field='')[source]#

This method creates a BodyCharge object.

Note

This function can be accessed by:

mdb.models[name].BodyCharge

Note

Check BodyCharge on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

Returns:

A BodyCharge object.

Return type:

BodyCharge

BodyConcentrationFlux(name, createStepName, region, magnitude, field='', distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET)[source]#

This method creates a BodyConcentrationFlux object.

Note

This function can be accessed by:

mdb.models[name].BodyConcentrationFlux

Note

Check BodyConcentrationFlux on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the body concentration flux magnitude. magnitude is optional if distributionType = USER_DEFINED.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the body concentration flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A BodyConcentrationFlux object.

Return type:

BodyConcentrationFlux

BodyCurrent(name, createStepName, region, magnitude, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, field='')[source]#

This method creates a BodyCurrent object.

Note

This function can be accessed by:

mdb.models[name].BodyCurrent

Note

Check BodyCurrent on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

Returns:

A BodyCurrent object.

Return type:

BodyCurrent

BodyCurrentDensity(name, createStepName, region, comp1, comp2, comp3, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM)[source]#

This method creates a BodyCurrentDensity object.

Note

This function can be accessed by:

mdb.models[name].BodyCurrentDensity

Note

Check BodyCurrentDensity on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • comp1 (str) – A Complex specifying the first component of the load.

  • comp2 (str) – A Complex specifying the second component of the load.

  • comp3 (str) – A Complex specifying the third component of the load.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

Returns:

A BodyCurrentDensity object.

Return type:

BodyCurrentDensity

BodyForce(name, createStepName, region, field='', distributionType=abaqusConstants.UNIFORM, comp1=None, comp2=None, comp3=None, amplitude=abaqusConstants.UNSET)[source]#

This method creates a BodyForce object.

Note

This function can be accessed by:

mdb.models[name].BodyForce

Note

Check BodyForce on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • comp1 (Optional[float], default: None) – A Float or a Complex specifying the body force component in the 1-direction.Note:Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero unless distributionType = USER_DEFINED.

  • comp2 (Optional[float], default: None) – A Float or a Complex specifying the body force component in the 2-direction.

  • comp3 (Optional[float], default: None) – A Float or a Complex specifying the body force component in the 3-direction.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A BodyForce object.

Return type:

BodyForce

BodyHeatFlux(name, createStepName, region, magnitude, field='', distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET)[source]#

This method creates a BodyHeatFlux object.

Note

This function can be accessed by:

mdb.models[name].BodyHeatFlux

Note

Check BodyHeatFlux on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the body heat flux magnitude. magnitude is optional if distributionType = USER_DEFINED.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the body heat flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A BodyHeatFlux object.

Return type:

BodyHeatFlux

BoltLoad(name, createStepName, region, magnitude, datumAxis, boltMethod=abaqusConstants.APPLY_FORCE, amplitude=abaqusConstants.UNSET, preTenSecPartLevel=False)[source]#

This method creates a BoltLoad object.

Note

This function can be accessed by:

mdb.models[name].BoltLoad

Note

Check BoltLoad on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the bolt load magnitude.

  • datumAxis (DatumAxis) – A DatumAxis object specifying the orientation of the pre-tension section normal.Note: datumAxis is applicable only for Solid and Shell regions; it has no meaning for Wire regions.

  • boltMethod (SymbolicConstant, default: APPLY_FORCE) – A SymbolicConstant specifying the method of applying the bolt load. Possible values are APPLY_FORCE and ADJUST_LENGTH. The default value is APPLY_FORCE.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • preTenSecPartLevel (Union[AbaqusBoolean, bool], default: False) –

    A Boolean specifying whether the pre-tension section is to be defined at the part level. The default value is False. You should provide the preTenSecPartLevel argument only if the selected region belongs to a dependent part instance. A pre-tension section cannot be defined at the part level for independent and model instances.

    New in version 2018: The preTenSecPartLevel argument was added.

Returns:

A BoltLoad object.

Return type:

BoltLoad

Raises:

TextError –

BoxProfile(name, a, b, uniformThickness, t1, t2=0, t3=0, t4=0)[source]#

This method creates a BoxProfile object.

Note

This function can be accessed by:

mdb.models[name].BoxProfile
session.odbs[name].BoxProfile

Note

Check BoxProfile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • a (float) – A Float specifying the a dimension of the box profile. For more information, see [Beam cross-section library](https://help.3ds.com/2021/English/DSSIMULIA_Established/SIMACAEELMRefMap/simaelm-c-beamcrosssectlib.htm?ContextScope=all).

  • b (float) – A Float specifying the b dimension of the box profile.

  • uniformThickness (Union[AbaqusBoolean, bool]) – A Boolean specifying whether the thickness is uniform.

  • t1 (float) – A Float specifying the uniform wall thickness if uniformThickness = ON, and the wall thickness of the first segment if uniformThickness = OFF.

  • t2 (float, default: 0) – A Float specifying the wall thickness of the second segment. t2 is required only when uniformThickness = OFF. The default value is 0.0.

  • t3 (float, default: 0) – A Float specifying the wall thickness of the third segment. t3 is required only when uniformThickness = OFF. The default value is 0.0.

  • t4 (float, default: 0) – A Float specifying the wall thickness of the fourth segment. t4 is required only when uniformThickness = OFF. The default value is 0.0.

Returns:

A BoxProfile object.

Return type:

BoxProfile

Raises:

RangeError –

BuckleStep(name, previous, numEigen, description='', eigensolver=abaqusConstants.SUBSPACE, minEigen=None, maxEigen=None, vectors=None, maxIterations=30, blockSize=abaqusConstants.DEFAULT, maxBlocks=abaqusConstants.DEFAULT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False)[source]#

This method creates a BuckleStep object.

Note

This function can be accessed by:

mdb.models[name].BuckleStep

Note

Check BuckleStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • numEigen (int) – An Int specifying the number of eigenvalues to be estimated.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • eigensolver (SymbolicConstant, default: SUBSPACE) – A SymbolicConstant specifying the eigensolver. Possible values are SUBSPACE and LANCZOS. The default value is SUBSPACE.

  • minEigen (Optional[float], default: None) – None or a Float specifying the minimum eigenvalue of interest. The default value is None.

  • maxEigen (Optional[float], default: None) – None or a Float specifying the maximum eigenvalue of interest. The default value is None.

  • vectors (Optional[int], default: None) – An Int specifying the number of vectors used in the iteration. The default value is the minimum of (2*n*, n + 8), where n is the number of eigenvalues requested.

  • maxIterations (int, default: 30) – An Int specifying the maximum number of iterations. The default value is 30.

  • blockSize (SymbolicConstant, default: DEFAULT) – The SymbolicConstant DEFAULT or an Int specifying the size of the Lanczos block steps. The default value is DEFAULT.

  • maxBlocks (SymbolicConstant, default: DEFAULT) – The SymbolicConstant DEFAULT or an Int specifying the maximum number of Lanczos block steps within each Lanczos run. The default value is DEFAULT.Note:minEigen, blockSize, and maxBlocks are ignored unless eigensolver = LANCZOS.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

Returns:

step – A BuckleStep object.

Return type:

BuckleStep

ButterworthFilter(name, cutoffFrequency, order=2, operation=abaqusConstants.NONE, halt=OFF, limit=None, invariant=abaqusConstants.NONE)[source]#

This method creates a ButterworthFilter object.

Note

This function can be accessed by:

mdb.models[name].ButterworthFilter
session.odbs[name].ButterworthFilter

Note

Check ButterworthFilter on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key. This name ANTIALIASING is reserved for filters generated internally by the program.

  • cutoffFrequency (float) – A Float specifying the attenuation point of the filter. Possible values are non-negative numbers. Order is not available for OperatorFilter.

  • order (int, default: 2) – An Int specifying the highest power of the filter transfer function. Possible values are non-negative numbers less than or equal to 20. Order is not available for OperatorFilter. The default value is 2.

  • operation (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the filter operator. Possible values are NONE, MIN, MAX, and ABS. The default value is NONE.

  • halt (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to stop the analysis if the specified limit is reached. The default value is OFF.

  • limit (Optional[float], default: None) – None or a Float specifying the threshold limit, an upper or lower bound for output values depending on the operation, or a bound for stopping the analysis when Halt is used. The default value is None.

  • invariant (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the invariant to which filtering is applied. Possible values are NONE, FIRST, and SECOND. The default value is NONE.

Returns:

A ButterworthFilter object.

Return type:

ButterworthFilter

Raises:

  • InvalidNameError –

  • RangeError –

Calibration(name)[source]#

This method creates a Calibration object.

Note

This function can be accessed by:

mdb.models[name].Calibration

Note

Check Calibration on help.3ds.com/2021.

Parameters:

name (str) – A String specifying the name of the new calibration.

Returns:

A Calibration object.

Return type:

Calibration

CavityRadiation(name, createStepName, surfaces, surfaceEmissivities=(), ambientTemp=None, blocking=abaqusConstants.BLOCKING_ALL, blockingSurfaces=None, rangeOfView=None, surfaceReflection=ON, viewfactorAccurTol=0, minInfinitesimalRatio=64, numPointsPerEdge=3, minLumpedAreaDS=5, cyclicSymmetry=OFF, cyclicImages=2, cyclicRotPt=None, cyclicRotEndPt=None, cyclicSymPt=None, periodicSymmetries=0, periodicImages_1=2, periodicImages_2=2, periodicImages_3=2, periodicSymAxis_1='', periodicSymAxis_2='', periodicSymPlane_1='', periodicSymPlane_2='', periodicSymPlane_3='', periodicDistance_1=(), periodicDistance_2=(), periodicDistance_3=(), periodicSymZ=None, periodicDistZ=None, reflectionSymmetries=0, reflectionSymAxis_1='', reflectionSymAxis_2='', reflectionSymPlane_1='', reflectionSymPlane_2='', reflectionSymPlane_3='', reflectionSymZ=None)[source]#

This method creates a CavityRadiation object.

Note

This function can be accessed by:

mdb.models[name].CavityRadiation

Note

Check CavityRadiation on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the cavity radiation interaction should be created.

  • surfaces (List[Region]) – A RegionArray object specifying the surfaces for which radiation viewfactor control is being specified.

  • surfaceEmissivities (tuple, default: ()) – A sequence of Strings specifying the names of the Cavity Radiation properties containing the surface emissivity data. One name per specified surface. The emissivity data is ignored when surfaceReflection = OFF.

  • ambientTemp (Optional[float], default: None) – None or a Float specifying the reference ambient temperature value, θ0θ0. Specifying a value indicates an open cavity. The default value is None.

  • blocking (SymbolicConstant, default: BLOCKING_ALL) – A SymbolicConstant specifying the blocking checks to be performed in the viewfactor calculations. Possible values are BLOCKING_ALL, NO_BLOCKING, and PARTIAL_BLOCKING. The default value is BLOCKING_ALL.

  • blockingSurfaces (Optional[List[Region]], default: None) – A RegionArray object specifying the surfaces that provide blocking inside the cavity. This argument applies only when blocking = PARTIAL_BLOCKING.

  • rangeOfView (Optional[float], default: None) – None or a Float specifying the maximum distance between surface facets at which viewfactors are calculated. More distant facets are deemed too far apart to exchange significant amounts of heat through radiation effects, and the viewfactors between these facets are assumed to be zero. If rangeOfView = None, there is no upper limit. The default value is None.

  • surfaceReflection (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether heat reflections are to be included in the cavity radiation calculations. The default value is ON.

  • viewfactorAccurTol (float, default: 0) – A Float specifying the acceptable tolerance for the viewfactor calculations. The default value is 0.05.

  • minInfinitesimalRatio (float, default: 64) – A Float specifying the facet area ratio above which the infinitesimal-to-finite area approximation is used for viewfactor calculations. The default value is 64.0.

  • numPointsPerEdge (int, default: 3) – An Int specifying the number of Gauss integration points to be used along each edge when the numerical integration of contour integrals is used for viewfactor calculations. One to five integration points are allowed. The default value is 3.

  • minLumpedAreaDS (float, default: 5) – A Float specifying the nondimensional distance-square value above which the lumped area approximation is used for viewfactor calculations. The default value is 5.0.

  • cyclicSymmetry (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether cyclic symmetry will be applied. This argument cannot be specified for axisymmetric models. The default value is OFF.

  • cyclicImages (int, default: 2) – An Int specifying the number of cyclically similar images that compose the cavity formed as a result of this symmetry. This argument applies only when cyclicSymmetry = ON. The default value is 2.

  • cyclicRotPt (Optional[ModelDot], default: None) – A ModelDot object specifying the rotation axis point. This argument applies only when cyclicSymmetry = ON.

  • cyclicRotEndPt (Optional[ModelDot], default: None) – A ModelDot object specifying the rotation axis end point. This argument applies only for three-dimensional models, and only when cyclicSymmetry = ON.

  • cyclicSymPt (Optional[ModelDot], default: None) – A ModelDot object specifying the symmetry axis end point. This argument applies only when cyclicSymmetry = ON.

  • periodicSymmetries (int, default: 0) – An Int specifying the number of periodic symmetries that will be applied. The default value is 0.

  • periodicImages_1 (int, default: 2) – An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the first periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_1. This argument applies only when periodicSymmetries is greater than zero. The default value is 2.

  • periodicImages_2 (int, default: 2) – An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the second periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_2. This argument applies only when periodicSymmetries is greater than one. The default value is 2.

  • periodicImages_3 (int, default: 2) – An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the third periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_3. This argument applies only when periodicSymmetries = 3. The default value is 2.

  • periodicSymAxis_1 (str, default: '') – A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the first line of symmetry in two-dimensional models. This argument applies only for 2D models, and when periodicSymmetries is greater than zero.

  • periodicSymAxis_2 (str, default: '') – A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the second line of symmetry in two-dimensional models. This argument applies only for two-dimensional models, and when periodicSymmetries = 2.

  • periodicSymPlane_1 (str, default: '') – A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the first plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when periodicSymmetries is greater than zero.

  • periodicSymPlane_2 (str, default: '') – A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the second plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when periodicSymmetries is greater than one.

  • periodicSymPlane_3 (str, default: '') – A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the third plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when periodicSymmetries = 3.

  • periodicDistance_1 (tuple, default: ()) – A sequence of sequences of Floats specifying the two points of the vector that describes the periodic distance for the first periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries is greater than zero. The default value is an empty sequence.

  • periodicDistance_2 (tuple, default: ()) – A sequence of sequences of Floats specifying the two points of the vector that describes the periodic distance for the second periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries is greater than one. The default value is an empty sequence.

  • periodicDistance_3 (tuple, default: ()) – A sequence of sequences of Floats specifying the two points of the vector that describes the periodic distance for the third periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries = 3. The default value is an empty sequence.

  • periodicSymZ (Optional[float], default: None) – None or a Float specifying the Z value indicating the symmetry reference line in axisymmetric models. This argument applies only for axisymmetric models, and when periodicSymmetries = 1. The default value is None.

  • periodicDistZ (Optional[float], default: None) – None or a Float specifying the Z value indicating the periodic distance in axisymmetric models. This argument applies only for axisymmetric models, and when periodicSymmetries = 1. The default value is None.

  • reflectionSymmetries (int, default: 0) – An Int specifying the number of reflection symmetries will be applied. The default value is 0.

  • reflectionSymAxis_1 (str, default: '') – A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the first line of symmetry in two-dimensional models. This argument applies only for two-dimensional models, and when reflectionSymmetries is greater than zero.

  • reflectionSymAxis_2 (str, default: '') – A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the second line of symmetry in two-dimensional models. This argument applies only for two-dimensional models, and when reflectionSymmetries = 2.

  • reflectionSymPlane_1 (str, default: '') – A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the first plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when reflectionSymmetries is greater than zero.

  • reflectionSymPlane_2 (str, default: '') – A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the second plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when reflectionSymmetries is greater than one.

  • reflectionSymPlane_3 (str, default: '') – A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the third plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when reflectionSymmetries = 3.

  • reflectionSymZ (Optional[float], default: None) – None or a Float specifying the Z value indicating the symmetry reference line in axisymmetric models. This argument applies only for axisymmetric models, and when reflectionSymmetries = 1. The default value is None.

Returns:

A CavityRadiation object.

Return type:

CavityRadiation

CavityRadiationProp(name, temperatureDependency=OFF, dependencies=0, property=())[source]#

This method creates a CavityRadiationProp object.

Note

This function can be accessed by:

mdb.models[name].CavityRadiationProp

Note

Check CavityRadiationProp on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • property (tuple, default: ()) – A sequence of sequences of Floats specifying the following:The emissivity, ϵϵ.Temperature, if the data depend on temperature.Value of the first field variable, if the data depend on field variables.Value of the second field variable.Etc.

Returns:

A CavityRadiationProp object.

Return type:

CavityRadiationProp

Chebyshev1Filter(name, cutoffFrequency, rippleFactor=0, order=2, operation=abaqusConstants.NONE, halt=OFF, limit=None, invariant=abaqusConstants.NONE)[source]#

This method creates a Chebyshev1Filter object.

Note

This function can be accessed by:

mdb.models[name].Chebyshev1Filter
session.odbs[name].Chebyshev1Filter

Note

Check Chebyshev1Filter on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key. This name ANTIALIASING is reserved for filters generated internally by the program.

  • cutoffFrequency (float) – A Float specifying the attenuation point of the filter. Possible values are non-negative numbers. Order is not available for OperatorFilter.

  • rippleFactor (float, default: 0) – A Float specifying the amount of allowable ripple in the filter. Possible values are non-negative numbers. The default value is 0.225.

  • order (int, default: 2) – An Int specifying the highest power of the filter transfer function. Possible values are non-negative numbers less than or equal to 20. Order is not available for OperatorFilter. The default value is 2.

  • operation (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the filter operator. Possible values are NONE, MIN, MAX, and ABS. The default value is NONE.

  • halt (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to stop the analysis if the specified limit is reached. The default value is OFF.

  • limit (Optional[float], default: None) – None or a Float specifying the threshold limit, an upper or lower bound for output values depending on the operation, or a bound for stopping the analysis when Halt is used. The default value is None.

  • invariant (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the invariant to which filtering is applied. Possible values are NONE, FIRST, and SECOND. The default value is NONE.

Returns:

A Chebyshev1Filter object.

Return type:

Chebyshev1Filter

Raises:

  • InvalidNameError –

  • RangeError –

Chebyshev2Filter(name, cutoffFrequency, rippleFactor=0, order=2, operation=abaqusConstants.NONE, halt=OFF, limit=None, invariant=abaqusConstants.NONE)[source]#

This method creates a Chebyshev2Filter object.

Note

This function can be accessed by:

mdb.models[name].Chebyshev2Filter
session.odbs[name].Chebyshev2Filter

Note

Check Chebyshev2Filter on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key. This name ANTIALIASING is reserved for filters generated internally by the program.

  • cutoffFrequency (float) – A Float specifying the attenuation point of the filter. Possible values are non-negative numbers. Order is not available for OperatorFilter.

  • rippleFactor (float, default: 0) – A Float specifying the amount of allowable ripple in the filter. Possible values are non-negative numbers less than 1. The default value is 0.025.

  • order (int, default: 2) – An Int specifying the highest power of the filter transfer function. Possible values are non-negative numbers less than or equal to 20. Order is not available for OperatorFilter. The default value is 2.

  • operation (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the filter operator. Possible values are NONE, MIN, MAX, and ABS. The default value is NONE.

  • halt (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to stop the analysis if the specified limit is reached. The default value is OFF.

  • limit (Optional[float], default: None) – None or a Float specifying the threshold limit, an upper or lower bound for output values depending on the operation, or a bound for stopping the analysis when Halt is used. The default value is None.

  • invariant (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the invariant to which filtering is applied. Possible values are NONE, FIRST, and SECOND. The default value is NONE.

Returns:

A Chebyshev2Filter object.

Return type:

Chebyshev2Filter

Raises:

  • InvalidNameError –

  • RangeError –

CircularProfile(name, r)[source]#

This method creates a CircularProfile object.

Note

This function can be accessed by:

mdb.models[name].CircularProfile
session.odbs[name].CircularProfile

Note

Check CircularProfile on help.3ds.com/2021.

Parameters:
Returns:

A CircularProfile object.

Return type:

CircularProfile

Raises:

RangeError –

CohesiveSection(name, response, material, initialThicknessType=abaqusConstants.SOLVER_DEFAULT, initialThickness=1, outOfPlaneThickness=None)[source]#

This method creates a CohesiveSection object.

Note

This function can be accessed by:

mdb.models[name].CohesiveSection
session.odbs[name].CohesiveSection

Note

Check CohesiveSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • response (Literal[TRACTION_SEPARATION, CONTINUUM, GASKET]) – A SymbolicConstant specifying the geometric assumption that defines the constitutive behavior of the cohesive elements. Possible values are TRACTION_SEPARATION, CONTINUUM, and GASKET.

  • material (str) – A String specifying the name of the material.

  • initialThicknessType (Literal[SOLVER_DEFAULT, SPECIFY], default: SOLVER_DEFAULT) – A SymbolicConstant specifying the method used to compute the initial thickness. Possible values are:SOLVER_DEFAULT, specifying that Abaqus will use the analysis product defaultGEOMETRY, specifying that Abaqus will compute the thickness from the nodal coordinates of the elements.SPECIFY, specifying that Abaqus will use the value given for initialThickness The default value is SOLVER_DEFAULT.

  • initialThickness (float, default: 1) – A Float specifying the initial thickness for the section. The initialThickness argument applies only when initialThicknessType = SPECIFY. The default value is 1.0.

  • outOfPlaneThickness (Optional[float], default: None) – None or a Float specifying the out-of-plane thickness for the section. The default value is None.

Returns:

A CohesiveSection object.

Return type:

CohesiveSection

Raises:

RangeError –

ComplexFrequencyStep(name, previous, numEigen=abaqusConstants.ALL, description='', shift=None, frictionDamping=OFF, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False, minEigen=None, maxEigen=None, propertyEvaluationFrequency=None)[source]#

This method creates a ComplexFrequencyStep object.

Note

This function can be accessed by:

mdb.models[name].ComplexFrequencyStep

Note

Check ComplexFrequencyStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • numEigen (SymbolicConstant, default: ALL) – The SymbolicConstant ALL or an Int specifying the number of complex eigenmodes to be calculated or a SymbolicConstant ALL. The default value is ALL.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • shift (Optional[float], default: None) – None or a Float specifying the shift point in cycles per time. The default value is None.

  • frictionDamping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • minEigen (Optional[float], default: None) – None or a Float specifying the minimum frequency of interest in cycles per time. The default value is None.

  • maxEigen (Optional[float], default: None) – None or a Float specifying the maximum frequency of interest in cycles per time. The default value is None.

  • propertyEvaluationFrequency (Optional[float], default: None) – None or a Float specifying the frequency at which to evaluate frequency-dependent properties for viscoelasticity, springs, and dashpots during the eigenvalue extraction. If the value is None, the analysis product will evaluate the stiffness associated with frequency-dependent springs and dashpots at zero frequency and will not consider the stiffness contributions from frequency-domain viscoelasticity in the step. The default value is None.

Returns:

step – A ComplexFrequencyStep object.

Return type:

ComplexFrequencyStep

CompositeShellSection(name, layup, symmetric=OFF, thicknessType=abaqusConstants.UNIFORM, preIntegrate=OFF, poissonDefinition=abaqusConstants.DEFAULT, poisson=0, integrationRule=abaqusConstants.SIMPSON, temperature=abaqusConstants.GRADIENT, idealization=abaqusConstants.NO_IDEALIZATION, nTemp=None, thicknessModulus=None, useDensity=OFF, density=0, layupName='', thicknessField='', nodalThicknessField='')[source]#

This method creates a CompositeShellSection object.

Note

This function can be accessed by:

mdb.models[name].parts[name].compositeLayups[i].CompositeShellSection
mdb.models[name].CompositeShellSection
session.odbs[name].CompositeShellSection

Note

Check CompositeShellSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • layup (List[SectionLayer]) – A SectionLayerArray object specifying the shell cross-section.

  • symmetric (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not the layup should be made symmetric by the analysis. The default value is OFF.

  • thicknessType (Literal[UNIFORM, ANALYTICAL_FIELD, DISCRETE_FIELD, NODAL_ANALYTICAL_FIELD, NODAL_DISCRETE_FIELD], default: UNIFORM) – A SymbolicConstant specifying the distribution used for defining the thickness of the elements. Possible values are UNIFORM, ANALYTICAL_FIELD, DISCRETE_FIELD, NODAL_ANALYTICAL_FIELD, and NODAL_DISCRETE_FIELD. The default value is UNIFORM.

  • preIntegrate (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the shell section properties are specified by the user prior to the analysis (ON) or integrated during the analysis (OFF). The default value is OFF.

  • poissonDefinition (Literal[DEFAULT, VALUE], default: DEFAULT) – A SymbolicConstant specifying whether to use the default value for the Poisson’s ratio. Possible values are:DEFAULT, specifying that the default value for the Poisson’s ratio is 0.5 in an Abaqus/Standard analysis and is obtained from the material definition in an Abaqus/Explicit analysis.VALUE, specifying that the Poisson’s ratio used in the analysis is the value provided in poisson.The default value is DEFAULT.

  • poisson (float, default: 0) – A Float specifying the Poisson’s ratio. Possible values are −1.0 ≤ poisson ≤ 0.5. This argument is valid only when poissonDefinition = VALUE. The default value is 0.5.

  • integrationRule (Literal[SIMPSON, GAUSS], default: SIMPSON) – A SymbolicConstant specifying the shell section integration rule. Possible values are SIMPSON and GAUSS. The default value is SIMPSON.

  • temperature (Literal[GRADIENT, POINTWISE], default: GRADIENT) – A SymbolicConstant specifying the mode used for temperature and field variable input across the section thickness. Possible values are GRADIENT and POINTWISE. The default value is GRADIENT.

  • idealization (Literal[NO_IDEALIZATION, SMEAR_ALL_LAYERS, MEMBRANE, BENDING], default: NO_IDEALIZATION) – A SymbolicConstant specifying the mechanical idealization used for the section calculations. This member is only applicable when preIntegrate is set to ON. Possible values are NO_IDEALIZATION, SMEAR_ALL_LAYERS, MEMBRANE, and BENDING. The default value is NO_IDEALIZATION.

  • nTemp (Optional[int], default: None) – None or an Int specifying the number of temperature points to be input. This argument is valid only when temperature = POINTWISE. The default value is None.

  • thicknessModulus (Optional[float], default: None) – None or a Float specifying the effective thickness modulus. This argument is relevant only for continuum shells and must be used in conjunction with the argument poisson. The default value is None.

  • useDensity (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not to use the value of density. The default value is OFF.

  • density (float, default: 0) – A Float specifying the value of density to apply to this section. The default value is 0.0.

  • layupName (str, default: '') – A String specifying the layup name for this section. The default value is an empty string.

  • thicknessField (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object used to define the thickness of the shell elements. The thicknessField argument applies only when thicknessType = ANALYTICAL_FIELD or thicknessType = DISCRETE_FIELD. The default value is an empty string.

  • nodalThicknessField (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object used to define the thickness of the shell elements at each node. The nodalThicknessField argument applies only when thicknessType = NODAL_ANALYTICAL_FIELD or thicknessType = NODAL_DISCRETE_FIELD. The default value is an empty string.

Returns:

A CompositeShellSection object.

Return type:

CompositeShellSection

CompositeSolidSection(name, layup, symmetric=OFF, layupName='')[source]#

This method creates a CompositeSolidSection object.

Note

This function can be accessed by:

mdb.models[name].CompositeSolidSection
session.odbs[name].CompositeSolidSection

Note

Check CompositeSolidSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • layup (List[SectionLayer]) – A SectionLayerArray object specifying the solid cross-section.

  • symmetric (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not the layup should be made symmetric by the analysis. The default value is OFF.

  • layupName (str, default: '') – A String specifying the layup name for this section. The default value is an empty string.

Returns:

A CompositeSolidSection object.

Return type:

CompositeSolidSection

ConcCharge(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET)[source]#

This method creates a ConcCharge object.

Note

This function can be accessed by:

mdb.models[name].ConcCharge

Note

Check ConcCharge on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConcCharge object.

Return type:

ConcCharge

ConcConcFlux(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET)[source]#

This method creates a ConcConcFlux object.

Note

This function can be accessed by:

mdb.models[name].ConcConcFlux

Note

Check ConcConcFlux on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConcConcFlux object.

Return type:

ConcConcFlux

ConcCurrent(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET)[source]#

This method creates a ConcCurrent object.

Note

This function can be accessed by:

mdb.models[name].ConcCurrent

Note

Check ConcCurrent on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConcCurrent object.

Return type:

ConcCurrent

ConcPoreFluid(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET)[source]#

This method creates a ConcPoreFluid object.

Note

This function can be accessed by:

mdb.models[name].ConcPoreFluid

Note

Check ConcPoreFluid on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConcPoreFluid object.

Return type:

ConcPoreFluid

ConcentratedFilmCondition(name, createStepName, region, definition, nodalArea=1, explicitRegionType=abaqusConstants.LAGRANGIAN, interactionProperty='', field='', sinkTemperature=0, sinkAmplitude='', filmCoeff=0, filmCoeffAmplitude='', sinkFieldName='', sinkDistributionType=abaqusConstants.UNIFORM)[source]#

This method creates a ConcentratedFilmCondition object.

Note

This function can be accessed by:

mdb.models[name].ConcentratedFilmCondition

Note

Check ConcentratedFilmCondition on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the ConcentratedFilmCondition object is created.

  • region (Region) – A Region object specifying the region to which the concentrated film condition interaction is applied. The interaction is applied to each node in the region.

  • definition (SymbolicConstant) – A SymbolicConstant specifying how the concentrated film condition is defined. Possible values are EMBEDDED_COEFF, PROPERTY_REF, USER_SUB, and FIELD.

  • nodalArea (float, default: 1) – A Float specifying the area associated with the node where the concentrated film condition is applied. The default value is 1.0.

  • explicitRegionType (SymbolicConstant, default: LAGRANGIAN) – A SymbolicConstant specifying how the concentrated film condition is applied to the boundary of an adaptive mesh domain. Possible values are LAGRANGIAN, SLIDING, and EULERIAN. The default value is LAGRANGIAN. This argument applies only during an Abaqus/Explicit analysis.

  • interactionProperty (str, default: '') – A String specifying the name of the FilmConditionProp object associated with this interaction. The interactionProperty argument applies only when definition = PROPERTY_REF. The default value is an empty string.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when definition = FIELD. The default value is an empty string.

  • sinkTemperature (float, default: 0) – A Float specifying the reference sink temperature, θ0θ0. The default value is 0.0.

  • sinkAmplitude (str, default: '') – A String specifying the name of the Amplitude object that gives the variation of the sink temperature, θ0θ0, with time. The default value is an empty string.Note:Use None in an Abaqus/Standard analysis to specify that the reference sink temperature is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference sink temperature is applied throughout the step.

  • filmCoeff (float, default: 0) – A Float specifying the reference film coefficient value, hh. The filmCoeff argument applies when definition = EMBEDDED_COEFF, definition = USER_SUB, or definition = FIELD. The default value is 0.0.

  • filmCoeffAmplitude (str, default: '') – A String specifying the name of the Amplitude object that gives the variation of the film coefficient, hh, with time. The default value is an empty string.Note:Use None in an Abaqus/Standard analysis to specify that the reference film coefficient is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference film coefficient is applied throughout the step.

  • sinkFieldName (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object associated with the sink temperature. The sinkFieldName argument applies only when sinkDistributionType = ANALYTICAL_FIELD or sinkDistributionType = DISCRETE_FIELD. The default value is an empty string.

  • sinkDistributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the sink temperature is distributed. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

Returns:

A ConcentratedFilmCondition object.

Return type:

ConcentratedFilmCondition

ConcentratedForce(name, createStepName, region, distributionType=abaqusConstants.UNIFORM, field='', cf1=None, cf2=None, cf3=None, amplitude=abaqusConstants.UNSET, follower=OFF, localCsys=None)[source]#

This method creates a ConcentratedForce object.

Note

This function can be accessed by:

mdb.models[name].ConcentratedForce

Note

Check ConcentratedForce on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • cf1 (Optional[float], default: None) – A Float or a Complex specifying the concentrated force component in the 1-direction. Although cf1, cf2, and cf3 are optional arguments, at least one of them must be nonzero.

  • cf2 (Optional[float], default: None) – A Float or a Complex specifying the concentrated force component in the 2-direction.

  • cf3 (Optional[float], default: None) – A Float or a Complex specifying the concentrated force component in the 3-direction.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • follower (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the direction of the force rotates with the rotation at each node of the region. You should provide the follower argument only if it is valid for the specified step. The default value is OFF.

  • localCsys (Optional[int], default: None) – None or a DatumCsys object specifying the local coordinate system of the load’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

Returns:

A ConcentratedForce object.

Return type:

ConcentratedForce

ConcentratedHeatFlux(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET, dof=11)[source]#

This method creates a ConcentratedHeatFlux object.

Note

This function can be accessed by:

mdb.models[name].ConcentratedHeatFlux

Note

Check ConcentratedHeatFlux on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • dof (int, default: 11) – An Int specifying the degree of freedom of the node, to which the concentrated heat flux should be applied. The default value is 11.

Returns:

A ConcentratedHeatFlux object.

Return type:

ConcentratedHeatFlux

ConcentratedRadiationToAmbient(name, createStepName, region, ambientTemperature, ambientTemperatureAmp, emissivity, nodalArea=1, explicitRegionType=abaqusConstants.LAGRANGIAN, field='', distributionType=abaqusConstants.UNIFORM)[source]#

This method creates a ConcentratedRadiationToAmbient object.

Note

This function can be accessed by:

mdb.models[name].ConcentratedRadiationToAmbient

Note

Check ConcentratedRadiationToAmbient on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the ConcentratedRadiationToAmbient object is created.

  • region (Region) – A Region object specifying the region to which the concentrated radiation interaction is applied. The interaction is applied to each node in the region.

  • ambientTemperature (float) – A Float specifying the reference ambient temperature, θ0θ0.

  • ambientTemperatureAmp (str) – A String specifying the name of the Amplitude object that gives the variation of the ambient temperature with time.Note:Use None in an Abaqus/Standard analysis to specify that the reference ambient temperature is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference ambient temperature is applied throughout the step.

  • emissivity (float) – A Float specifying the emissivity, ϵϵ.

  • nodalArea (float, default: 1) – A Float specifying the area associated with the node where the concentrated radiation interaction is applied. The default value is 1.0.

  • explicitRegionType (SymbolicConstant, default: LAGRANGIAN) – A SymbolicConstant specifying how the concentrated radiation is applied to the boundary of an adaptive mesh domain. Possible values are LAGRANGIAN, SLIDING, and EULERIAN. The default value is LAGRANGIAN.Note:explicitRegionType applies only during an Abaqus/Explicit analysis.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when distributionType = ANALYTICAL_FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the radiation is defined. Possible values are UNIFORM and ANALYTICAL_FIELD. The default value is UNIFORM.

Returns:

A ConcentratedRadiationToAmbient object.

Return type:

ConcentratedRadiationToAmbient

ConcentrationBC(name, createStepName, region, fieldName='', magnitude=0, distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET, fixed=OFF)[source]#

This method creates a ConcentrationBC object.

Note

This function can be accessed by:

mdb.models[name].ConcentrationBC

Note

Check ConcentrationBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • magnitude (float, default: 0) – A Float specifying the concentration magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A ConcentrationBC object.

Return type:

ConcentrationBC

ConnAccelerationBC(name, createStepName, region='', fastenerName='', fastenerSetName='', a1=abaqusConstants.UNSET, a2=abaqusConstants.UNSET, a3=abaqusConstants.UNSET, ar1=abaqusConstants.UNSET, ar2=abaqusConstants.UNSET, ar3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM)[source]#

This method creates an ConnAccelerationBC object on a wire region. Alternatively, the boundary condition may also be applied to a wire set referenced from an assembled fastener template model.

Note

This function can be accessed by:

mdb.models[name].ConnAccelerationBC

Note

Check ConnAccelerationBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (str, default: '') – The wire region to which the boundary condition is applied. This argument is not valid when fastenerName and fastenerSetName are specified.

  • fastenerName (str, default: '') – A String specifying the name of the assembled fastener to which the boundary condition will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

  • fastenerSetName (str, default: '') – A String specifying the assembled fastener template model set to which the boundary condition will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

  • a1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the acceleration component in the connector’s local 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.Note:Although a1, a2, a3, ar1, ar2, and ar3 are optional arguments, at least one of them must be specified.

  • a2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the acceleration component in the connector’s local 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • a3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the acceleration component in the connector’s local 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ar1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational acceleration component in the connector’s local 4-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ar2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational acceleration component in the connector’s local 5-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ar3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational acceleration component in the connector’s local 6-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

Returns:

bc – A ConnAccelerationBC object.

Return type:

ConnAccelerationBC

ConnDisplacementBC(name, createStepName, region='', fastenerName='', fastenerSetName='', u1=abaqusConstants.UNSET, u2=abaqusConstants.UNSET, u3=abaqusConstants.UNSET, ur1=abaqusConstants.UNSET, ur2=abaqusConstants.UNSET, ur3=abaqusConstants.UNSET, fixed=OFF, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, buckleCase=abaqusConstants.NOT_APPLICABLE)[source]#

This method creates a ConnDisplacementBC object on a wire region. Alternatively, the boundary condition may also be applied to a wire set referenced from an assembled fastener template model.

Note

This function can be accessed by:

mdb.models[name].ConnDisplacementBC

Note

Check ConnDisplacementBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (str, default: '') – The wire region to which the boundary condition is applied. This argument is not valid when fastenerName and fastenerSetName are specified.

  • fastenerName (str, default: '') – A String specifying the name of the assembled fastener to which the boundary condition will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

  • fastenerSetName (str, default: '') – A String specifying the assembled fastener template model set to which the boundary condition will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

  • u1 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.Note:Although u1, u2, u3, ur1, ur2, and ur3 are optional arguments, at least one of them must be specified.

  • u2 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • u3 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur1 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 4-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur2 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 5-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur3 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 6-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

Returns:

bc – A ConnDisplacementBC object.

Return type:

ConnDisplacementBC

ConnVelocityBC(name, createStepName, region='', fastenerName='', fastenerSetName='', v1=abaqusConstants.UNSET, v2=abaqusConstants.UNSET, v3=abaqusConstants.UNSET, vr1=abaqusConstants.UNSET, vr2=abaqusConstants.UNSET, vr3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM)[source]#

This method creates a ConnVelocityBC object on a wire region. Alternatively, the boundary condition may also be applied to a wire set referenced from an assembled fastener template model.

Note

This function can be accessed by:

mdb.models[name].ConnVelocityBC

Note

Check ConnVelocityBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (str, default: '') – The wire region to which the boundary condition is applied. This argument is not valid when fastenerName and fastenerSetName are specified.

  • fastenerName (str, default: '') – A String specifying the name of the assembled fastener to which the boundary condition will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

  • fastenerSetName (str, default: '') – A String specifying the assembled fastener template model set to which the boundary condition will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

  • v1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the connector’s local 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.Note:Although v1, v2, v3, vr1, vr2, and vr3 are optional arguments, at least one of them must be specified.

  • v2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the connector’s local 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • v3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the connector’s local 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 4-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 5-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 6-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

Returns:

bc – A ConnVelocityBC object.

Return type:

ConnVelocityBC

ConnectorForce(name, createStepName, region='', fastenerName='', fastenerSetName='', f1=None, f2=None, f3=None, amplitude=abaqusConstants.UNSET)[source]#

This method creates a ConnectorForce object on a wire region. Alternatively, the load may also be applied to a wire set referenced from an assembled fastener template model.

Note

This function can be accessed by:

mdb.models[name].ConnectorForce

Note

Check ConnectorForce on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (str, default: '') – The wire region to which the load is applied. This argument is not valid when fastenerName and fastenerSetName are specified.

  • fastenerName (str, default: '') – A String specifying the name of the assembled fastener to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

  • fastenerSetName (str, default: '') – A String specifying the assembled fastener template model set to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

  • f1 (Optional[float], default: None) – A Float or a Complex specifying the connector force component in the connector’s local 1-direction.Note:Although f1, f2, and f3 are optional arguments, at least one of them must be nonzero.

  • f2 (Optional[float], default: None) – A Float or a Complex specifying the connector force component in the connector’s local 2-direction.

  • f3 (Optional[float], default: None) – A Float or a Complex specifying the connector force component in the connector’s local 3-direction.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConnectorForce object.

Return type:

ConnectorForce

ConnectorMoment(name, createStepName, region='', fastenerName='', fastenerSetName='', m1=None, m2=None, m3=None, amplitude=abaqusConstants.UNSET)[source]#

This method creates a ConnectorMoment object on a wire region. Alternatively, the load may also be applied to a wire set referenced from an assembled fastener template model.

Note

This function can be accessed by:

mdb.models[name].ConnectorMoment

Note

Check ConnectorMoment on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (str, default: '') – The wire region to which the load is applied. This argument is not valid when fastenerName and fastenerSetName are specified.

  • fastenerName (str, default: '') – A String specifying the name of the assembled fastener to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

  • fastenerSetName (str, default: '') – A String specifying the assembled fastener template model set to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

  • m1 (Optional[float], default: None) – A Float or a Complex specifying the moment component in the connector’s local 4-direction.

  • m2 (Optional[float], default: None) – A Float or a Complex specifying the moment component in the connector’s local 5-direction.

  • m3 (Optional[float], default: None) – A Float or a Complex specifying the moment component in the connector’s local 6-direction.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConnectorMoment object.

Return type:

ConnectorMoment

ConnectorSection(name, assembledType=abaqusConstants.NONE, rotationalType=abaqusConstants.NONE, translationalType=abaqusConstants.NONE, integration=abaqusConstants.UNSPECIFIED, u1ReferenceLength=None, u2ReferenceLength=None, u3ReferenceLength=None, ur1ReferenceAngle=None, ur2ReferenceAngle=None, ur3ReferenceAngle=None, massPerLength=None, contactAngle=None, materialFlowFactor=1.0, regularize=ON, defaultTolerance=ON, regularization=0.03, extrapolation=abaqusConstants.CONSTANT, behaviorOptions=Ellipsis)[source]#

This method creates a ConnectorSection object.

Note

This function can be accessed by:

mdb.models[name].ConnectorSection
session.odbs[name].ConnectorSection

Note

Check ConnectorSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • assembledType (Literal[NONE, BEAM, BUSHING, CVJOINT, CYLINDRICAL, HINGE, PLANAR, RETRACTOR, SLIPRING, TRANSLATOR, UJOINT, WELD], default: NONE) – A SymbolicConstant specifying the assembled connection type. Possible values are:NONEBEAMBUSHINGCVJOINTCYLINDRICALHINGEPLANARRETRACTORSLIPRINGTRANSLATORUJOINTWELDThe default value is NONE.You cannot include the assembledType argument if translationalType or rotationalType are given a value other than NONE. At least one of the arguments assembledType, translationalType, or rotationalType must be given a value other than NONE.

  • rotationalType (Literal[NONE, ALIGN, CARDAN, CONSTANT_VELOCITY, EULER, FLEXION_TORSION, FLOW_CONVERTER, PROJECTION_FLEXION_TORSION, REVOLUTE, ROTATION, ROTATION_ACCELEROMETER, UNIVERSAL], default: NONE) – A SymbolicConstant specifying the basic rotational connection type. Possible values are:NONEALIGNCARDANCONSTANT_VELOCITYEULERFLEXION_TORSIONFLOW_CONVERTERPROJECTION_FLEXION_TORSIONREVOLUTEROTATIONROTATION_ACCELEROMETERUNIVERSALThe default value is NONE.You cannot include the rotationalType argument if assembledType is given a value other than NONE. At least one of the arguments assembledType, translationalType, or rotationalType must be given an value other than NONE.

  • translationalType (Literal[NONE, ACCELEROMETER, AXIAL, CARTESIAN, JOIN, LINK, PROJECTION_CARTESIAN, RADIAL_THRUST, SLIDE_PLANE, SLOT], default: NONE) – A SymbolicConstant specifying the basic translational connection type. Possible values are:NONEACCELEROMETERAXIALCARTESIANJOINLINKPROJECTION_CARTESIANRADIAL_THRUSTSLIDE_PLANESLOTThe default value is NONE.You cannot include the translationalType argument if assembledType is given a value other than NONE. At least one of the arguments assembledType, translationalType, or rotationalType must be given an value other than NONE.

  • integration (Literal[UNSPECIFIED, IMPLICIT, EXPLICIT], default: UNSPECIFIED) – A SymbolicConstant specifying the time integration scheme to use for analysis. This argument is applicable only to an Abaqus/Explicit analysis. Possible values are UNSPECIFIED, IMPLICIT, and EXPLICIT. The default value is UNSPECIFIED.

  • u1ReferenceLength (Optional[float], default: None) – None or a Float specifying the reference length associated with constitutive response for the first component of relative motion. The default value is None.

  • u2ReferenceLength (Optional[float], default: None) – None or a Float specifying the reference length associated with constitutive response for the second component of relative motion. The default value is None.

  • u3ReferenceLength (Optional[float], default: None) – None or a Float specifying the reference length associated with constitutive response for the third component of relative motion. The default value is None.

  • ur1ReferenceAngle (Optional[float], default: None) – None or a Float specifying the reference angle in degrees associated with constitutive response for the fourth component of relative motion. The default value is None.

  • ur2ReferenceAngle (Optional[float], default: None) – None or a Float specifying the reference angle in degrees associated with constitutive response for the fifth component of relative motion. The default value is None.

  • ur3ReferenceAngle (Optional[float], default: None) – None or a Float specifying the reference angle in degrees associated with constitutive response for the sixth component of relative motion. The default value is None.

  • massPerLength (Optional[float], default: None) – None or a Float specifying the mass per unit reference length of belt material. This argument is applicable only when assembledType = SLIPRING, and must be specified in that case. The default value is None.

  • contactAngle (Optional[float], default: None) – None or a Float specifying the contact angle made by the belt wrapping around node b. This argument is applicable only to an Abaqus/Explicit analysis, and only when assembledType = SLIPRING. The default value is None.

  • materialFlowFactor (float, default: 1.0) – A Float specifying the scaling factor for material flow at node b. This argument is applicable only when assembledType = RETRACTOR or rotationalType = FLOW_CONVERTER. The default value is 1.0.

  • regularize (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether or not all tabular data associated with the behaviorOptions will be regularized. This argument is applicable only for an Abaqus/Explicit analysis. The default value is ON.

  • defaultTolerance (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether or not the default regularization tolerance will be used for all tabular data associated with the behaviorOptions. This argument is applicable only for an Abaqus/Explicit analysis and only if regularize = ON. The default value is ON.

  • regularization (float, default: 0.03) – A Float specifying the regularization increment to be used for all tabular data associated with the behaviorOptions. This argument is applicable only for an Abaqus/Explicit analysis and only if regularize = ON and defaultTolerance = OFF. The default value is 0.03.

  • extrapolation (Literal[CONSTANT, LINEAR], default: CONSTANT) – A SymbolicConstant specifying the extrapolation technique to be used for all tabular data associated with the behaviorOptions. Possible values are CONSTANT and LINEAR. The default value is CONSTANT.

  • behaviorOptions (List[ConnectorBehaviorOption], default: Ellipsis) – A ConnectorBehaviorOptionArray object.

Returns:

A ConnectorSection object.

Return type:

ConnectorSection

Raises:

  • InvalidNameError –

  • RangeError –

ConstrainedSketch(name, sheetSize, gridSpacing=None, transform=())[source]#

This method creates a ConstrainedSketch object. If the sketch cannot be created, the method returns None.

Note

This function can be accessed by:

mdb.models[name].ConstrainedSketch

Note

Check ConstrainedSketch on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • sheetSize (float) – A Float specifying the sheet size.

  • gridSpacing (Optional[float], default: None) – A Float specifying the spacing between gridlines. Possible values are Floats >> 0. The default value is approximately 2 percent of sheetSize.

  • transform (tuple, default: ()) – A sequence of sequences of Floats specifying the three-dimensional orientation of the sketch. The sequence is a 3 × 4 transformation matrix specifying the axis of rotation and the translation vector. Possible values are any Floats.The default value for the axis of rotation is the identity matrix`(1.0, 0.0, 0.0), (0.0, 1.0, 0.0), (0.0, 0.0, 1.0)`The default value for the translation vector is`(0.0, 0.0, 0.0)`The default values position the sketch on the X - Y plane centered at the origin.

Returns:

sketch – A ConstrainedSketch object.

Return type:

ConstrainedSketch

ContactExp(name, createStepName, useAllstar=OFF, globalSmoothing=ON, includedPairs=None, excludedPairs=None, contactPropertyAssignments=None, surfaceThicknessAssignments=None, surfaceOffsetAssignments=None, surfaceFeatureAssignments=None, smoothingAssignments=None, surfaceCrushTriggerAssignments=<abaqus.Interaction.SurfaceCrushTriggerAssignment.SurfaceCrushTriggerAssignment object>, surfaceFrictionAssignments=<abaqus.Interaction.SurfaceFrictionAssignment.SurfaceFrictionAssignment object>, mainSecondaryAssignments=None, polarityAssignments=<abaqus.Interaction.PolarityAssignments.PolarityAssignments object>)[source]#

This method creates a ContactExp object.

Note

This function can be accessed by:

mdb.models[name].ContactExp

Note

Check ContactExp on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which this contact interaction is created.

  • useAllstar (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the contacting surface pair consists of all exterior faces, shell edges, beam segments, analytical rigid surfaces, and, when applicable, Eulerian material surfaces.

  • globalSmoothing (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether surface smoothing (geometric correction) is automatically applied to all eligible surfaces. The default value is ON.

  • includedPairs (Optional[RegionPairs], default: None) – A RegionPairs object specifying the domain pairs included in contact.

  • excludedPairs (Optional[RegionPairs], default: None) – A RegionPairs object specifying the domain pairs excluded from contact.

  • contactPropertyAssignments (Optional[ContactPropertyAssignment], default: None) – A ContactPropertyAssignment object specifying the contact property assignments in the contact domain.

  • surfaceThicknessAssignments (Optional[SurfaceThicknessAssignment], default: None) – A SurfaceThicknessAssignment object specifying the surface thickness assignments in the contact domain.

  • surfaceOffsetAssignments (Optional[SurfaceOffsetAssignment], default: None) – A SurfaceOffsetAssignment object specifying the surface offset fraction assignments in the contact domain.

  • surfaceFeatureAssignments (Optional[SurfaceFeatureAssignment], default: None) – A SurfaceFeatureAssignment object specifying the surface feature angle assignments in the contact domain.

  • smoothingAssignments (Optional[SmoothingAssignment], default: None) – A SmoothingAssignment object specifying the surface smoothing assignments in the contact domain.

  • surfaceCrushTriggerAssignments (SurfaceCrushTriggerAssignment, default: <abaqus.Interaction.SurfaceCrushTriggerAssignment.SurfaceCrushTriggerAssignment object at 0x7f99933a3a30>) –

    A SurfaceCrushTriggerAssignment object specifying the surface crush trigger assignments in the contact domain.

    New in version 2021: The surfaceCrushTriggerAssignments argument was added.

  • surfaceFrictionAssignments (SurfaceFrictionAssignment, default: <abaqus.Interaction.SurfaceFrictionAssignment.SurfaceFrictionAssignment object at 0x7f9993568970>) –

    A SurfaceFrictionAssignment object specifying the surface friction assignments in the contact domain.

    New in version 2021: The surfaceFrictionAssignments argument was added.

  • mainSecondaryAssignments (Optional[MasterSlaveAssignment], default: None) – A MasterSlaveAssignment object specifying the master-slave assignments in the contact domain.

  • polarityAssignments (PolarityAssignments, default: <abaqus.Interaction.PolarityAssignments.PolarityAssignments object at 0x7f99934939d0>) –

    A PolarityAssignments object specifying the polarity assignments in the contact domain.

    New in version 2020: The polarityAssignments argument was added.

Returns:

A ContactExp object.

Return type:

ContactExp

ContactProperty(name)[source]#

This method creates a ContactProperty object.

Note

This function can be accessed by:

mdb.models[name].ContactProperty

Note

Check ContactProperty on help.3ds.com/2021.

Parameters:

name (str) – A String specifying the interaction property repository key.

Returns:

A ContactProperty object.

Return type:

ContactProperty

ContactStd(name, createStepName, useAllstar=OFF, globalSmoothing=ON, includedPairs=None, excludedPairs=None, contactPropertyAssignments=None, surfaceThicknessAssignments=None, surfaceOffsetAssignments=None, surfaceFeatureAssignments=None, surfaceBeamSmoothingAssignments=<abaqus.Interaction.SurfaceBeamSmoothingAssignment.SurfaceBeamSmoothingAssignment object>, surfaceVertexCriteriaAssignments=<abaqus.Interaction.SurfaceVertexCriteriaAssignment.SurfaceVertexCriteriaAssignment object>, slidingFormulationAssignments=None, mainSecondaryAssignments=None, initializationAssignments=None, stabilizationAssignments=None, smoothingAssignments=None, slidingTransitionAssignments=None)[source]#

This method creates a ContactStd object.

Note

This function can be accessed by:

mdb.models[name].ContactStd

Note

Check ContactStd on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which this contact interaction is created.

  • useAllstar (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the contacting surface pairs consist of all exterior faces in the model.

  • globalSmoothing (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether surface smoothing (geometric correction) is automatically applied to all eligible surfaces. The default value is ON.

  • includedPairs (Optional[RegionPairs], default: None) – A RegionPairs object specifying the domain pairs included in contact.

  • excludedPairs (Optional[RegionPairs], default: None) – A RegionPairs object specifying the domain pairs excluded from contact.

  • contactPropertyAssignments (Optional[ContactPropertyAssignment], default: None) – A ContactPropertyAssignment object specifying the contact property assignments in the contact domain.

  • surfaceThicknessAssignments (Optional[SurfaceThicknessAssignment], default: None) – A SurfaceThicknessAssignment object specifying the surface thickness assignments in the contact domain.

  • surfaceOffsetAssignments (Optional[SurfaceOffsetAssignment], default: None) – A SurfaceOffsetAssignment object specifying the surface offset fraction assignments in the contact domain.

  • surfaceFeatureAssignments (Optional[SurfaceFeatureAssignment], default: None) – A SurfaceFeatureAssignment object specifying the surface feature angle assignments in the contact domain.

  • surfaceBeamSmoothingAssignments (SurfaceBeamSmoothingAssignment, default: <abaqus.Interaction.SurfaceBeamSmoothingAssignment.SurfaceBeamSmoothingAssignment object at 0x7f99935a0df0>) –

    A SurfaceBeamSmoothingAssignment object specifying the surface beam smoothing assignments in the contact domain.

    New in version 2021: The surfaceBeamSmoothingAssignments argument was added.

  • surfaceVertexCriteriaAssignments (SurfaceVertexCriteriaAssignment, default: <abaqus.Interaction.SurfaceVertexCriteriaAssignment.SurfaceVertexCriteriaAssignment object at 0x7f999333b970>) –

    A SurfaceVertexCriteriaAssignment object specifying the surface vertex criteria assignments in the contact domain.

    New in version 2021: The surfaceVertexCriteriaAssignments argument was added.

  • slidingFormulationAssignments (Optional[Tuple[SlidingFormulationAssignment, ...]], default: None) –

    A sequence of tuples of SlidingFormulationAssignment specifying the sliding formulation assignments. Each tuple contains two entries:

    • A region object or the SymbolicConstant GLOBAL specifying the surface to which the sliding formulation attribute is assigned.

    • A SymbolicConstant specifying the overriding the smoothness value to be used for the first surface. Possible values of the SymbolicConstant are NONE and SMALL_SLIDING.

    New in version 2021: The slidingFormulationAssignments argument was added.

  • mainSecondaryAssignments (Optional[MasterSlaveAssignment], default: None) – A MasterSlaveAssignment object specifying the master-slave assignments in the contact domain.

  • initializationAssignments (Optional[InitializationAssignment], default: None) – An InitializationAssignment object specifying the contact initialization assignments in the contact domain.

  • stabilizationAssignments (Optional[StabilizationAssignment], default: None) – A StabilizationAssignment object specifying the contact stabilization assignments in the contact domain.

  • smoothingAssignments (Optional[SmoothingAssignment], default: None) – A SmoothingAssignment object specifying the surface smoothing assignments in the contact domain.

  • slidingTransitionAssignments (Optional[SlidingTransitionAssignment], default: None) – A SlidingTransitionAssignments object specifying the sliding transition assignments in the contact domain.

Returns:

A ContactStd object.

Return type:

ContactStd

CoriolisForce(name, createStepName, region, magnitude, point1, point2, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, field='')[source]#

This method creates a CoriolisForce object.

Note

This function can be accessed by:

mdb.models[name].CoriolisForce

Note

Check CoriolisForce on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • point1 (tuple) – A sequence of Floats specifying the first point on the axis of rotation for the load.

  • point2 (tuple) – A sequence of Floats specifying the second point on the axis of rotation for the load.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

Returns:

A CoriolisForce object.

Return type:

CoriolisForce

CoupledTempDisplacementStep(name, previous, description='', response=abaqusConstants.TRANSIENT, timePeriod=1, nlgeom=OFF, stabilizationMethod=abaqusConstants.NONE, stabilizationMagnitude=None, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None, deltmx=0, cetol=0, creepIntegration=abaqusConstants.IMPLICIT, solutionTechnique=abaqusConstants.FULL_NEWTON, matrixStorage=abaqusConstants.SOLVER_DEFAULT, amplitude=abaqusConstants.STEP, extrapolation=abaqusConstants.LINEAR, maintainAttributes=False, convertSDI=abaqusConstants.PROPAGATED, adaptiveDampingRatio=0, continueDampingFactors=OFF)[source]#

This method creates a CoupledTempDisplacementStep object.

Note

This function can be accessed by:

mdb.models[name].CoupledTempDisplacementStep

Note

Check CoupledTempDisplacementStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • response (SymbolicConstant, default: TRANSIENT) – A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

  • timePeriod (float, default: 1) – A Float specifying the total time period for the step. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.

  • stabilizationMethod (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

  • stabilizationMagnitude (Optional[float], default: None) – A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable and stabilizationMethod ≠ NONE. The default value is 2×10-4.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • deltmx (float, default: 0) – A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.

  • cetol (float, default: 0) – A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

  • creepIntegration (SymbolicConstant, default: IMPLICIT) – A SymbolicConstant specifying the type of integration to be used for creep and swelling effects throughout the step. Possible values are IMPLICIT, EXPLICIT, and NONE. The default value is IMPLICIT.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the type of solution technique. Possible values are FULL_NEWTON and SEPARATED. The default value is FULL_NEWTON.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

  • adaptiveDampingRatio (float, default: 0) – A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

  • continueDampingFactors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step – A CoupledTempDisplacementStep object.

Return type:

CoupledTempDisplacementStep

CoupledThermalElectricStep(name, previous, description='', response=abaqusConstants.TRANSIENT, timePeriod=1, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None, end=abaqusConstants.PERIOD, deltmx=0, mxdem=0, solutionTechnique=abaqusConstants.FULL_NEWTON, matrixStorage=abaqusConstants.SOLVER_DEFAULT, amplitude=abaqusConstants.STEP, extrapolation=abaqusConstants.LINEAR, maintainAttributes=False, convertSDI=abaqusConstants.PROPAGATED)[source]#

This method creates a CoupledThermalElectricStep object.

Note

This function can be accessed by:

mdb.models[name].CoupledThermalElectricStep

Note

Check CoupledThermalElectricStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • response (SymbolicConstant, default: TRANSIENT) – A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

  • timePeriod (float, default: 1) – A Float specifying the total time period for the step. The default value is 1.0.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • end (SymbolicConstant, default: PERIOD) – A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.

  • deltmx (float, default: 0) – A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.

  • mxdem (float, default: 0) – A Float specifying the maximum allowable emissivity change with temperature and field variables during an increment. The default value is 0.1.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the type of solution technique. Possible values are FULL_NEWTON and SEPARATED. The default value is FULL_NEWTON.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

Returns:

step – A CoupledThermalElectricStep object.

Return type:

CoupledThermalElectricStep

CoupledThermalElectricalStructuralStep(name, previous, description='', response=abaqusConstants.TRANSIENT, timePeriod=1, nlgeom=OFF, stabilizationMethod=abaqusConstants.NONE, stabilizationMagnitude=None, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None, deltmx=0, cetol=0, creepIntegration=abaqusConstants.IMPLICIT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, amplitude=abaqusConstants.STEP, extrapolation=abaqusConstants.LINEAR, maintainAttributes=False, convertSDI=abaqusConstants.PROPAGATED, adaptiveDampingRatio=0, continueDampingFactors=OFF)[source]#

This method creates a CoupledThermalElectricalStructuralStep object.

Note

This function can be accessed by:

mdb.models[name].CoupledThermalElectricalStructuralStep

Note

Check CoupledThermalElectricalStructuralStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • response (SymbolicConstant, default: TRANSIENT) – A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

  • timePeriod (float, default: 1) – A Float specifying the total time period for the step. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.

  • stabilizationMethod (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

  • stabilizationMagnitude (Optional[float], default: None) – A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable and stabilizationMethod ≠ NONE. The default value is 2×10-4.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • deltmx (float, default: 0) – A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.

  • cetol (float, default: 0) – A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

  • creepIntegration (SymbolicConstant, default: IMPLICIT) – A SymbolicConstant specifying the type of integration to be used for creep and swelling effects throughout the step. Possible values are IMPLICIT, EXPLICIT, and NONE. The default value is IMPLICIT.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

  • adaptiveDampingRatio (float, default: 0) – A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

  • continueDampingFactors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step – A CoupledThermalElectricalStructuralStep object.

Return type:

CoupledThermalElectricalStructuralStep

Coupling(name, surface, controlPoint, influenceRadius, couplingType, adjust=OFF, localCsys=None, u1=ON, u2=ON, u3=ON, ur1=ON, ur2=ON, ur3=ON, weightingMethod=abaqusConstants.UNIFORM)[source]#

This method creates a Coupling object.

Note

This function can be accessed by:

mdb.models[name].Coupling

Note

Check Coupling on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • surface (Region) – A Region object specifying the surface on which the coupling nodes are located.

  • controlPoint (Region) – A Region object specifying the constraint control point.

  • influenceRadius (Union[SymbolicConstant, float]) – The SymbolicConstant WHOLE_SURFACE or a Float specifying the influence radius.

  • couplingType (SymbolicConstant) – A SymbolicConstant specifying the coupling constraint type. Possible values are KINEMATIC, DISTRIBUTING, and STRUCTURAL.

  • adjust (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying if the control point will be adjusted (moved) to the surface. The point will be adjusted in the direction normal to the specified surface. The default value is OFF.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the initial orientation of the local coordinate system for the coupling’s degrees of freedom. If localCsys = None, the coupling is defined in the global coordinate system. The default value is None.

  • u1 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying if the displacement component in the 1-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u1 argument applies only when couplingType = KINEMATIC.

  • u2 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying if the displacement component in the 2-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u2 argument applies only when couplingType = KINEMATIC.

  • u3 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying if the displacement component in the 3-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u3 argument applies only when couplingType = KINEMATIC.

  • ur1 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying if the rotational displacement component about the 1-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur1 argument applies only when couplingType = KINEMATIC.

  • ur2 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying if the rotational displacement component about the 2-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur2 argument applies only when couplingType = KINEMATIC.

  • ur3 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying if the rotational displacement component about the 3-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur3 argument applies only when couplingType = KINEMATIC.

  • weightingMethod (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying an optional weighting method used for calculating the distributing weight factors. Possible values are UNIFORM, LINEAR, QUADRATIC, and CUBIC. The default value is UNIFORM.The weightingMethod argument applies only when couplingType = DISTRIBUTING.

Returns:

A Coupling object.

Return type:

Coupling

CyclicSymmetry(name, createStepName, master, slave, repetitiveSectors, axisPoint1, axisPoint2, extractedNodalDiameter=abaqusConstants.ALL_NODAL_DIAMETER, lowestNodalDiameter=0, highestNodalDiameter=0, excitationNodalDiameter=0, adjustTie=ON, positionTolerance=0, positionToleranceMethod=abaqusConstants.COMPUTED_TOLERANCE)[source]#

This method creates a CyclicSymmetry object.

Note

This function can be accessed by:

mdb.models[name].CyclicSymmetry

Note

Check CyclicSymmetry on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the cyclic symmetry interaction should be created.

  • master (Region) – A Region object specifying the master surface.

  • slave (Region) – A Region object specifying the slave surface.

  • repetitiveSectors (int) – An Int specifying the total number of sectors in the cyclic symmetric model.

  • axisPoint1 (Region) – A Region object specifying the first point of the axis of symmetry. The region should contain exactly one mesh node, vertex, interesting point, reference point, or datum point. In a two-dimensional model axisPoint1 is the only point used to define the axis of symmetry.

  • axisPoint2 (Region) – A Region object specifying the second point of the axis of symmetry. The region should contain exactly one mesh node, vertex, interesting point, reference point, or datum point. This point is ignored in a two-dimensional model.

  • extractedNodalDiameter (SymbolicConstant, default: ALL_NODAL_DIAMETER) – A SymbolicConstant specifying whether Abaqus should extract all possible nodal diameters or the nodal diameters between the user-specified values for lowestNodalDiameter and highestNodalDiameter. Possible values are ALL_NODAL_DIAMETER and SPECIFIED_NODAL_DIAMETER. The default value is ALL_NODAL_DIAMETER.

  • lowestNodalDiameter (int, default: 0) – An Int specifying the lowest nodal diameter to be used in the eigenfrequency analysis. The default value is 0.

  • highestNodalDiameter (int, default: 0) – An Int specifying the highest nodal diameter to be used in the eigenfrequency analysis. This argument value should be less than or equal to the half of the total number of sectors (as specified in the repetitiveSectors parameter). The default value is 0.

  • excitationNodalDiameter (int, default: 0) – An Int specifying the nodal diameter for which the modal-based steady-state dynamic analysis will be performed. This value should be greater than or equal to the lowest nodal diameter (specified in the lowestNodalDiameter parameter), and less than or equal to the highest nodal diameter (specified in the highestNodalDiameter parameter). The default value is 0.

  • adjustTie (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether or not to adjust the slave surface of the cyclic symmetry to tie it to the master surface. The default value is ON.

  • positionTolerance (float, default: 0) – A Float specifying the position tolerance. The*positionTolerance* argument applies only when positionToleranceMethod = SPECIFY_TOLERANCE. The default value is 0.0.

  • positionToleranceMethod (SymbolicConstant, default: COMPUTED_TOLERANCE) – A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED_TOLERANCE and SPECIFY_TOLERANCE. The default value is COMPUTED_TOLERANCE.

Returns:

A CyclicSymmetry object.

Return type:

CyclicSymmetry

DecayAmplitude(name, initial, maximum, start, decayTime, timeSpan=abaqusConstants.STEP)[source]#

This method creates a DecayAmplitude object.

Note

This function can be accessed by:

mdb.models[name].DecayAmplitude
session.odbs[name].DecayAmplitude

Note

Check DecayAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • initial (float) – A Float specifying the constant A0A0.

  • maximum (float) – A Float specifying the coefficient AA.

  • start (float) – A Float specifying the starting time t0t0. Possible values are non-negative numbers.

  • decayTime (float) – A Float specifying the decay time tdtd. Possible values are non-negative numbers.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A DecayAmplitude object.

Return type:

DecayAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

DirectCyclicStep(name, previous, description='', timePeriod=1, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None, maxNumIterations=200, initialTerms=11, maxTerms=25, termsIncrement=5, deltmx=0, cetol=0, timePoints=abaqusConstants.NONE, fatigue=OFF, continueAnalysis=OFF, minCycleInc=100, maxCycleInc=1000, maxNumCycles=abaqusConstants.DEFAULT, damageExtrapolationTolerance=1, matrixStorage=abaqusConstants.SOLVER_DEFAULT, extrapolation=abaqusConstants.LINEAR, maintainAttributes=False, convertSDI=abaqusConstants.PROPAGATED)[source]#

This method creates a DirectCyclicStep object.

Note

This function can be accessed by:

mdb.models[name].DirectCyclicStep

Note

Check DirectCyclicStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • timePeriod (float, default: 1) – A Float specifying the time of single loading cycle. The default value is 1.0.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • maxNumIterations (int, default: 200) – An Int specifying the maximum number of iterations in a step. The default value is 200.

  • initialTerms (int, default: 11) – An Int specifying the initial number of terms in the Fourier series. The default value is 11.

  • maxTerms (int, default: 25) – An Int specifying the maximum number of terms in the Fourier series. The default value is 25.

  • termsIncrement (int, default: 5) – An Int specifying the increment in number of terms in the Fourier series. The default value is 5.

  • deltmx (float, default: 0) – A Float specifying the maximum temperature change to be allowed in an increment. The default value is 0.0.

  • cetol (float, default: 0) – A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

  • timePoints (str, default: NONE) – None or a String specifying a String specifying the name of a time point object used to determine at which times the response of the structure will be evaluated. The default value is NONE.

  • fatigue (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include low-cycle fatigue analysis. The default value is OFF.

  • continueAnalysis (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the displacement solution in the Fourier series obtained in the previous direct cyclic step is used as the starting values for the current step. The default value is OFF.

  • minCycleInc (int, default: 100) – An Int specifying the minimum number of cycles over which the damage is extrapolated forward. The default value is 100.

  • maxCycleInc (int, default: 1000) – An Int specifying the maximum number of cycles over which the damage is extrapolated forward. The default value is 1000.

  • maxNumCycles (SymbolicConstant, default: DEFAULT) – The SymbolicConstant DEFAULT or an Int specifying the maximum number of cycles allowed in a step or DEFAULT. A value of 1 plus half of the maximum number of cycles will be used if DEFAULT is specified. The default value is DEFAULT.

  • damageExtrapolationTolerance (float, default: 1) – A Float specifying the maximum extrapolated damage increment. The default value is 1.0.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

Returns:

step – A DirectCyclicStep object.

Return type:

DirectCyclicStep

DisplacementAdaptiveMeshConstraint(name, createStepName, region, u1=abaqusConstants.UNSET, u2=abaqusConstants.UNSET, u3=abaqusConstants.UNSET, ur1=abaqusConstants.UNSET, ur2=abaqusConstants.UNSET, ur3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, motionType=abaqusConstants.INDEPENDENT, localCsys=None)[source]#

This method creates a DisplacementAdaptiveMeshConstraint object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

Check DisplacementAdaptiveMeshConstraint on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the adaptive mesh constraint repository key.

  • createStepName (str) – A String specifying the name of the step in which the adaptive mesh constraint is created.

  • region (Region) – A Region object specifying the region to which the adaptive mesh constraint is applied.

  • u1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the displacement component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET. Note: Although u1, u2, u3, ur1, ur2, and ur3 are optional arguments, at least one of them must be specified.

  • u2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the displacement component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • u3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the displacement component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational displacement component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational displacement component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational displacement component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the adaptive mesh constraint has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • motionType (SymbolicConstant, default: INDEPENDENT) – A SymbolicConstant specifying the mesh motion in relation to the underlying material. Possible values are INDEPENDENT, FOLLOW and USER_DEFINED. The default value is INDEPENDENT.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A DisplacementAdaptiveMeshConstraint object

Return type:

DisplacementAdaptiveMeshConstraint

DisplacementBC(name, createStepName, region, fieldName='', u1=abaqusConstants.UNSET, u2=abaqusConstants.UNSET, u3=abaqusConstants.UNSET, ur1=abaqusConstants.UNSET, ur2=abaqusConstants.UNSET, ur3=abaqusConstants.UNSET, fixed=OFF, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, localCsys=None, buckleCase=abaqusConstants.NOT_APPLICABLE)[source]#

This method creates a DisplacementBC object.

Note

This function can be accessed by:

mdb.models[name].DisplacementBC

Note

Check DisplacementBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD or distributionType = DISCRETE_FIELD. The default value is an empty string.

  • u1 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.Note:Although u1, u2, u3, ur1, ur2, and ur3 are optional arguments, at least one of them must be specified.

  • u2 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • u3 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur1 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur2 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur3 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

Returns:

bc – A DisplacementBC object

Return type:

DisplacementBC

DisplacementBaseMotionBC(name, createStepName, dof, amplitudeScaleFactor=1, centerOfRotation=(), correlation=None, secondaryBase='', useComplex=OFF, amplitude=abaqusConstants.UNSET)[source]#

This method creates a DisplacementBaseMotionBC object.

Note

This function can be accessed by:

mdb.models[name].DisplacementBaseMotionBC

Note

Check DisplacementBaseMotionBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • dof (SymbolicConstant) – A SymbolicConstant specifying the constrained degree-of-freedom. Possible values for the SymbolicConstant are U1, U2, U3, UR1, UR2, UR3. The default value is U1.

  • amplitudeScaleFactor (float, default: 1) – A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

  • centerOfRotation (tuple, default: ()) – A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

  • correlation (Optional[Correlation], default: None) – A Correlation object.

  • secondaryBase (str, default: '') – A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

  • useComplex (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

bc – A DisplacementBaseMotionBC object.

Return type:

DisplacementBaseMotionBC

DisplayBody(name, instance, controlPoints)[source]#

This method creates a DisplayBody object.

Note

This function can be accessed by:

mdb.models[name].DisplayBody

Note

Check DisplayBody on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • instance (PartInstance) – A PartInstance object specifying the part instance that is to be used for display only.

  • controlPoints (List[ModelDot]) – A ModelDotArray object specifying the motion of the PartInstance. The control points may be ConstrainedSketchVertex, ReferencePoint, or MeshNode objects. Their motion will control the motion of the PartInstance. If this argument is set to an empty sequence, the PartInstance will remain fixed in space during the analysis. The sequence can have either one object or three objects.

Returns:

A DisplayBody object.

Return type:

DisplayBody

ElasticFoundation(name, createStepName, surface, stiffness)[source]#

This method creates an ElasticFoundation object.

Note

This function can be accessed by:

mdb.models[name].ElasticFoundation

Note

Check ElasticFoundation on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the ElasticFoundation object is created. createStepName must be set to ‘Initial’.

  • surface (Region) – A Region object specifying the surface to which the foundation applies.

  • stiffness (float) – A Float specifying the foundation stiffness per area (or per length for beams).

Returns:

An ElasticFoundation object.

Return type:

ElasticFoundation

ElectricPotentialBC(name, createStepName, region, fieldName='', magnitude=0, distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET, fixed=OFF)[source]#

This method creates an ElectricPotentialBC object.

Note

This function can be accessed by:

mdb.models[name].ElectricPotentialBC

Note

Check ElectricPotentialBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • magnitude (float, default: 0) – A Float specifying the electrical potential magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – An ElectricPotentialBC object.

Return type:

ElectricPotentialBC

EmagTimeHarmonicStep(name, previous, frequencyRange, description='', factorization=abaqusConstants.COMPLEX)[source]#

This method creates a EmagTimeHarmonicStep object.

Note

This function can be accessed by:

mdb.models[name].EmagTimeHarmonicStep

Note

Check EmagTimeHarmonicStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • frequencyRange (List[EmagTimeHarmonicFrequency]) – An EmagTimeHarmonicFrequencyArray object.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • factorization (SymbolicConstant, default: COMPLEX) – A SymbolicConstant specifying whether damping terms are to be ignored so that a real, rather than a complex, system matrix is factored. Possible values are REAL_ONLY and COMPLEX. The default value is COMPLEX.

Returns:

step – An EmagTimeHarmonicStep object.

Return type:

EmagTimeHarmonicStep

EmbeddedRegion(name, embeddedRegion, hostRegion, weightFactorTolerance=None, toleranceMethod=abaqusConstants.BOTH, absoluteTolerance=0, fractionalTolerance=0)[source]#

This method creates a EmbeddedRegion object.

Note

This function can be accessed by:

mdb.models[name].EmbeddedRegion

Note

Check EmbeddedRegion on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • embeddedRegion (Region) – A Region object specifying the body region to be embedded.

  • hostRegion (Region) – A Region object specifying the host region. A value of None indicates that the host region is the whole model.

  • weightFactorTolerance (Optional[float], default: None) – A Float specifying a small value below which the weighting factors will be zeroed out. The default value is 10-6.

  • toleranceMethod (SymbolicConstant, default: BOTH) – A SymbolicConstant specifying the method used to determine the embedded element tolerance. Possible values are ABSOLUTE, FRACTIONAL, and BOTH. The default value is BOTH.

  • absoluteTolerance (float, default: 0) – A Float specifying the absolute value by which a node on the embedded region may lie outside the host region. If absoluteTolerance = 0.0, the fractionalTolerance value will be used. The default value is 0.0.This argument applies only when toleranceMethod = ABSOLUTE or BOTH.

  • fractionalTolerance (float, default: 0) – A Float specifying the fractional value by which a node on the embedded region may lie outside the host region. The fractional value is based on the average element size within the host region. The default value is 0.05.If both tolerance arguments are specified, the smaller value will be used.This argument applies only when toleranceMethod = FRACTIONAL or BOTH.

Returns:

An EmbeddedRegion object.

Return type:

EmbeddedRegion

EncastreBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]#

This method creates an encastre TypeBC object.

Note

This function can be accessed by:

mdb.models[name].EncastreBC

Note

Check EncastreBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

EquallySpacedAmplitude(name, fixedInterval, data, begin=0, smooth=abaqusConstants.SOLVER_DEFAULT, timeSpan=abaqusConstants.STEP)[source]#

This method creates an EquallySpacedAmplitude object.

Note

This function can be accessed by:

mdb.models[name].EquallySpacedAmplitude
session.odbs[name].EquallySpacedAmplitude

Note

Check EquallySpacedAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • fixedInterval (float) – A Float specifying the fixed time interval at which the amplitude data are given. Possible values are positive numbers.

  • data (tuple) – A sequence of Floats specifying the amplitude values.

  • begin (float, default: 0) – A Float specifying the time at which the first amplitude data are given. Possible values are non-negative numbers. The default value is 0.0.

  • smooth (Union[SymbolicConstant, float], default: SOLVER_DEFAULT) – The SymbolicConstant SOLVER_DEFAULT or a Float specifying the degree of smoothing. Possible float values are 0 ≤ smoothing ≤ 0.5. If smooth = SOLVER_DEFAULT, the default degree of smoothing will be determined by the solver. The default value is SOLVER_DEFAULT.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

An EquallySpacedAmplitude object.

Return type:

EquallySpacedAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

Equation(name, terms)[source]#

This method creates an Equation object.

Note

This function can be accessed by:

mdb.models[name].Equation

Note

Check Equation on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • terms (tuple) – A sequence of (Float, String, Int, Int) sequences specifying a coefficient, Set name, degree of freedom, and coordinate system ID. The coordinate system ID is optional.

Returns:

An Equation object.

Return type:

Equation

:raises If terms does not contain more than one entry`, Equation must have two or :class:`more terms.:

EulerianBC(name, createStepName, region, definition=abaqusConstants.INFLOW, inflowType=abaqusConstants.FREE, outflowType=abaqusConstants.ZERO_PRESSURE)[source]#

This method creates a EulerianBC object.

Note

This function can be accessed by:

mdb.models[name].EulerianBC

Note

Check EulerianBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • definition (SymbolicConstant, default: INFLOW) – A SymbolicConstant specifying the flow conditions to be defined. Possible values are INFLOW, OUTFLOW, and BOTH. The default value is INFLOW.

  • inflowType (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the control of material flow into the Eulerian domain. Possible values are FREE, NONE, and VOID. The default value is FREE.

  • outflowType (SymbolicConstant, default: ZERO_PRESSURE) – A SymbolicConstant specifying the control of flow of material out of the Eulerian domain. Possible values are ZERO_PRESSURE, FREE, NON_REFLECTING, and EQUILIBRIUM. The default value is ZERO_PRESSURE.

Returns:

bc – An EulerianBC object.

Return type:

EulerianBC

EulerianMotionBC(name, createStepName, instanceName, followRegion=ON, region=None, materialName='', ctrPosition1=abaqusConstants.FREE, posPosition1=abaqusConstants.FREE, negPosition1=abaqusConstants.FREE, expansionRatio1=None, contractRatio1=0, ctrPosition2=abaqusConstants.FREE, posPosition2=abaqusConstants.FREE, negPosition2=abaqusConstants.FREE, expansionRatio2=None, contractRatio2=0, ctrPosition3=abaqusConstants.FREE, posPosition3=abaqusConstants.FREE, negPosition3=abaqusConstants.FREE, expansionRatio3=None, contractRatio3=0, allowContraction=ON, aspectLimit=10, vmaxFactor=1, volThreshold=0, bufferSize=2)[source]#

This method creates an EulerianMotionBC object.

Note

This function can be accessed by:

mdb.models[name].EulerianMotionBC

Note

Check EulerianMotionBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • instanceName (str) – A String specifying the name of the Eulerian part instance.

  • followRegion (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the mesh will follow a regular surface region or an Eulerian surface. The default value is ON.

  • region (Optional[Region], default: None) – A Region object specifying the region to which the boundary condition is applied.

  • materialName (str, default: '') – A String specifying the name of the Eulerian surface to follow. This argument applies only when followRegion = False.

  • ctrPosition1 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the 1-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

  • posPosition1 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 1 direction. Possible values are FREE and FIXED. The default value is FREE.

  • negPosition1 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 1 direction. Possible values are FREE and FIXED. The default value is FREE.

  • expansionRatio1 (Optional[float], default: None) – None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 1 direction. If expansionRatio1 = None, then there is no upper limit. The default value is None.

  • contractRatio1 (float, default: 0) – A Float specifying the lower bounds on the allowable scaling of the mesh in the 1 direction. The default value is 0.0.

  • ctrPosition2 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the 2-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

  • posPosition2 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 2 direction. Possible values are FREE and FIXED. The default value is FREE.

  • negPosition2 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 2 direction. Possible values are FREE and FIXED. The default value is FREE.

  • expansionRatio2 (Optional[float], default: None) – None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 2 direction. If expansionRatio2 = None, then there is no upper limit. The default value is None.

  • contractRatio2 (float, default: 0) – A Float specifying the lower bounds on the allowable scaling of the mesh in the 2 direction. The default value is 0.0.

  • ctrPosition3 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the 3-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

  • posPosition3 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 3 direction. Possible values are FREE and FIXED. The default value is FREE.

  • negPosition3 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 3 direction. Possible values are FREE and FIXED. The default value is FREE.

  • expansionRatio3 (Optional[float], default: None) – None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 3 direction. If expansionRatio3 = None, then there is no upper limit. The default value is None.

  • contractRatio3 (float, default: 0) – A Float specifying the lower bounds on the allowable scaling of the mesh in the 3 direction. The default value is 0.0.

  • allowContraction (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the mesh is allowed to contract . The default value is ON.

  • aspectLimit (float, default: 10) – A Float specifying the maximum change in allowed aspect ratio (for any of the three mesh aspects, 1-2, 2-3, 3-1). The default value is 10.0.

  • vmaxFactor (float, default: 1) – A Float specifying the multiplier for the mesh nodal velocity limit. The default value is 1.01.

  • volThreshold (float, default: 0) – A Float specifying the lower bounds on the volume fraction when determining which nodes to include in the surface bounding box calculation for an Eulerian material surface. This argument applies only when followRegion = False. The default value is 0.5.

  • bufferSize (float, default: 2) – None or a Float specifying the buffer between the surface box and the Eulerian section mesh bounding box. The default value is 2.0.

Returns:

bc – An EulerianMotionBC object.

Return type:

EulerianMotionBC

EulerianSection(name, data)[source]#

This method creates a EulerianSection object.

Note

This function can be accessed by:

mdb.models[name].EulerianSection
session.odbs[name].EulerianSection

Note

Check EulerianSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • data (str) – A String-to-String Dictionary specifying a dictionary mapping Material instance names to Material names. Internally the specified mapping gets sorted on Material instance name.

Returns:

An EulerianSection object.

Return type:

EulerianSection

ExpContactControl(name, globTrkChoice=abaqusConstants.DEFAULT, globTrkInc=None, fastLocalTrk=ON, scalePenalty=1, warpCheckPeriod=20, warpCutoff=20)[source]#

This method creates an ExpContactControl object.

Note

This function can be accessed by:

mdb.models[name].ExpContactControl

Note

Check ExpContactControl on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the contact controls repository key.

  • globTrkChoice (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying whether or not the default value will be used for the maximum number of increments between global contact searches. Possible values are DEFAULT and SPECIFY. The default value is DEFAULT.

  • globTrkInc (Optional[int], default: None) – An Int specifying the maximum number of increments between global contact searches. The globTrkInc argument applies only when globTrkChoice = SPECIFY. The default value is 100 for surface-to-surface contact and 4 for self-contact.

  • fastLocalTrk (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to use the more computationally efficient local tracking method. The default value is ON.

  • scalePenalty (float, default: 1) – A Float specifying the factor by which Abaqus/Explicit will scale the default penalty stiffness to obtain the stiffnesses used for the penalty contact pairs. The default value is 1.0.

  • warpCheckPeriod (int, default: 20) – An Int specifying the number of increments between checks for highly warped facets on master surfaces. The default value is 20.

  • warpCutoff (float, default: 20) – A Float specifying the out-of-plane warping angle (in degrees), at which a facet will be considered to be highly warped. The default value is 20.0.

Returns:

An ExpContactControl object.

Return type:

ExpContactControl

Raises:

RangeError –

ExpInitialization(name, overclosureType=abaqusConstants.ADJUST, interferenceDistance=None, clearanceDistance=None, openingTolerance=None, overclosureTolerance=None, adjustNodalCoords=True, secondaryNodesetName=None, stepFraction=1)[source]#

This method creates an ExpInitialization object.

Note

This function can be accessed by:

mdb.models[name].ExpInitialization

Note

Check ExpInitialization on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the contact initialization repository key.

  • overclosureType (SymbolicConstant, default: ADJUST) – A SymbolicConstant specifying the type of overclosure to be defined. Possible values are ADJUST, INTERFERENCE, and CLEARANCE. The default value is ADJUST.

  • interferenceDistance (Optional[float], default: None) – None or a Float specifying the interference distance. This argument is valid only when overclosureType = INTERFERENCE. The default value is None.

  • clearanceDistance (Optional[float], default: None) – None or a Float specifying the initial clearance distance. This argument is valid only when overclosureType = CLEARANCE and must be specified in that case. The default value is None.

  • openingTolerance (Optional[float], default: None) – None or a Float specifying the distance tolerance within which initial openings will undergo strain-free adjustments. This argument is not valid when overclosureType = INTERFERENCE unless a value has been specified for interferenceDistance. The default value is None.

  • overclosureTolerance (Optional[float], default: None) – None or a Float specifying the distance tolerance within which initial overclosures will undergo strain-free adjustments. The default value is None.

  • adjustNodalCoords (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to resolve clearances/overclosures by adjusting the nodal coordinates without creating strain in the model. adjustNodalCoords = True can be used only for clearances/overclosures defined in the first step of an analysis. The default value is True.

  • secondaryNodesetName (Optional[str], default: None) –

    A String specifying the name of the node set containing the secondary nodes to be included in the initial clearance specification. This argument is not valid when overclosureType = INTERFERENCE and if openingTolerance or overclosureTolerance is specified. The default value is None.

    Changed in version 2022: The argument slaveNodesetName was renamed to secondaryNodesetName.

  • stepFraction (float, default: 1) – A Float specifying the fraction of the step time (between 0.0 and 1.0) in which the interference fit has to be solved. The default value is 1.0. This argument is valid only when overclosureType = INTERFERENCE.

Returns:

An ExpInitialization object.

Return type:

ExpInitialization

Raises:

RangeError –

ExplicitDynamicsStep(name, previous, description='', timePeriod=1, nlgeom=ON, adiabatic=OFF, timeIncrementationMethod=abaqusConstants.AUTOMATIC_GLOBAL, maxIncrement=None, scaleFactor=1, massScaling=abaqusConstants.PREVIOUS_STEP, linearBulkViscosity=0, quadBulkViscosity=1, userDefinedInc=None, maintainAttributes=False, improvedDtMethod=ON)[source]#

This method creates an ExplicitDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].ExplicitDynamicsStep

Note

Check ExplicitDynamicsStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • timePeriod (float, default: 1) – A Float specifying the total time period for the step. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is ON.

  • adiabatic (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that an adiabatic stress analysis is to be performed. The default value is OFF.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC_GLOBAL) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are AUTOMATIC_GLOBAL, AUTOMATIC_EBE, FIXED_USER_DEFINED_INC, and FIXED_EBE. The default value is AUTOMATIC_GLOBAL.

  • maxIncrement (Optional[float], default: None) – None or a Float specifying the maximum time increment. If there is no upper limit, maxIncrement = None. This argument is required only when timeIncrementationMethod = AUTOMATIC_GLOBAL or AUTOMATIC_EBE. The default value is None.

  • scaleFactor (float, default: 1) – A Float specifying the factor that is used to scale the time increment. This argument is required only when timeIncrementationMethod = AUTOMATIC_GLOBAL, AUTOMATIC_EBE, or FIXED_EBE. The default value is 1.0.

  • massScaling (List[MassScaling], default: PREVIOUS_STEP) – A MassScalingArray object specifying mass scaling controls. The default value is PREVIOUS_STEP.

  • linearBulkViscosity (float, default: 0) – A Float specifying the linear bulk viscosity parameter, b1b1. The default value is 0.06.

  • quadBulkViscosity (float, default: 1) – A Float specifying the quadratic bulk viscosity parameter, b2b2. The default value is 1.2.

  • userDefinedInc (Optional[float], default: None) – None or a Float specifying the user-defined time increment. This argument is required only when timeIncrementationMethod = FIXED_USER_DEFINED_INC. The default value is None.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • improvedDtMethod (Union[AbaqusBoolean, bool], default: ON) –

    A Boolean specifying whether to use the “improved” (improvedDtMethod = ON) or “conservative” (improvedDtMethod = OFF) method to estimate the element stable time increment for three-dimensional continuum elements and elements with plane stress formulations (shell, membrane, and two-dimensional plane stress elements). The default value is ON.

    New in version 2018: The improvedDtMethod argument was added.

Returns:

step – An ExplicitDynamicsStep object.

Return type:

ExplicitDynamicsStep

Field(name, createStepName, region, outputVariable='', fieldVariableNum=None, distributionType=abaqusConstants.UNIFORM, crossSectionDistribution=abaqusConstants.CONSTANT_THROUGH_THICKNESS, field='', amplitude=abaqusConstants.UNSET, fileName='', beginStep=None, beginIncrement=None, endStep=None, endIncrement=None, interpolate=OFF, magnitudes='')[source]#

This method creates a Field object.

Note

This function can be accessed by:

mdb.models[name].Field

New in version 2018: The Field method was added.

Note

Check Field on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the predefined field is created.

  • region (Region) – A Region object specifying the region to which the predefined field is applied. Region is ignored if the predefined field has a distributionType member available, and distributionType = FROM_FILE.

  • outputVariable (str, default: '') – A String specifying the scalar nodal output variable that will be read from an output database and used to initialize a specified predefined field. This argument is a required argument if distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.

  • fieldVariableNum (Optional[int], default: None) – An Int specifying the field variable number.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the predefined field varies spatially. Possible values are UNIFORM, USER_DEFINED, FROM_FILE, FIELD, FROM_FILE_AND_USER_DEFINED, and DISCRETE_FIELD. The default value is UNIFORM.

  • crossSectionDistribution (SymbolicConstant, default: CONSTANT_THROUGH_THICKNESS) –

    A SymbolicConstant specifying how the predefined field is distributed over the cross-section of the region. Possible values are

    • CONSTANT_THROUGH_THICKNESS

    • GRADIENTS_THROUGH_SHELL_CS

    • GRADIENTS_THROUGH_BEAM_CS

    • POINTS_THROUGH_SECTION

    The default value is CONSTANT_THROUGH_THICKNESS.

  • field (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object associated with this predefined field. The field argument applies only when distributionType = FIELD or distributionType = DISCRETE_FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) –

    A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the predefined field has no amplitude reference. The default value is UNSET.

    Note

    amplitude should be given only if it is valid for the specified step.

  • fileName (str, default: '') – A String specifying the name of the file from which the Field values are to be read when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.

  • beginStep (Optional[SymbolicConstant], default: None) – An Int specifying the first step from which Field values are to be read or the SymbolicConstant FIRST_STEP or LAST_STEP. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • beginIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the first increment of the step set in beginStep or the SymbolicConstants STEP_START or STEP_END. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • endStep (Optional[SymbolicConstant], default: None) – An Int specifying the last step from which Field values are to be read or the SymbolicConstants FIRST_STEP and LAST_STEP. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • endIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the last increment of the step set in endStep or the SymbolicConstants STEP_START and STEP_END. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • interpolate (SymbolicConstant, default: OFF) – A SymbolicConstant specifying whether to interpolate a field read from an output database or results file. Possible values are OFF, ON, or MIDSIDE_ONLY. The default value is OFF.

  • magnitudes (str, default: '') –

    A Sequence of Doubles specifying the Field values when distributionType = UNIFORM or FIELD. The value of the magnitudes argument is a function of the crossSectionDistribution argument, as shown in the following list:

    • If crossSectionDistribution = CONSTANT_THROUGH_THICKNESS, magnitudes is a Double specifying the Field.

    • If crossSectionDistribution = GRADIENTS_THROUGH_SHELL_CS, magnitudes is a sequence of Doubles specifying the mean value and the gradient in the thickness direction.

    • If crossSectionDistribution = GRADIENTS_THROUGH_BEAM_CS, magnitudes is a sequence of Doubles specifying the mean value, the gradient in the N1 direction, and the gradient in the N2 direction.

    • If crossSectionDistribution = POINTS_THROUGH_SECTION, magnitudes is a sequence of Doubles specifying the Field at each point.

Return type:

A Field object.

FieldOutputRequest(name, createStepName, region=abaqusConstants.MODEL, variables=abaqusConstants.PRESELECT, frequency=1, modes=abaqusConstants.ALL, timeInterval=abaqusConstants.EVERY_TIME_INCREMENT, numIntervals=20, timeMarks=OFF, boltLoad='', sectionPoints=abaqusConstants.DEFAULT, interactions=None, rebar=abaqusConstants.EXCLUDE, filter=None, directions=ON, fasteners='', assembledFastener='', assembledFastenerSet='', exteriorOnly=OFF, layupNames='', layupLocationMethod=abaqusConstants.SPECIFIED, outputAtPlyTop=False, outputAtPlyMid=True, outputAtPlyBottom=False, position=abaqusConstants.INTEGRATION_POINTS)[source]#

This method creates a FieldOutputRequest object.

Note

This function can be accessed by:

mdb.models[name].FieldOutputRequest

Note

Check FieldOutputRequest on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the object is created.

  • region (Union[Literal[MODEL], Region], default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region from which output is requested. The SymbolicConstant MODEL represents the whole model. The default value is MODEL.

  • variables (Union[Tuple[str, ...], Literal[PRESELECT, ALL]], default: PRESELECT) – A sequence of Strings specifying output request variable or component names, or the SymbolicConstant PRESELECT or ALL. PRESELECT represents all default output variables for the given step. ALL represents all valid output variables. The default value is PRESELECT.

  • frequency (Union[int, Literal[LAST_INCREMENT]], default: 1) – The SymbolicConstant LAST_INCREMENT or an Int specifying the output frequency in increments. The default value is 1.

  • modes (Union[Literal[ALL], Tuple[int, ...]], default: ALL) – The SymbolicConstant ALL or a sequence of Ints specifying a list of eigenmodes for which output is desired. The default value is ALL.

  • timeInterval (Union[Literal[EVERY_TIME_INCREMENT], float], default: EVERY_TIME_INCREMENT) – The SymbolicConstant EVERY_TIME_INCREMENT or a Float specifying the time interval at which the output states are to be written. The default value is EVERY_TIME_INCREMENT.

  • numIntervals (int, default: 20) – An Int specifying the number of intervals during the step at which output database states are to be written. The default value is 20.

  • timeMarks (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying when to write results to the output database. OFF indicates that output is written immediately after the time dictated by the specified number of intervals. ON indicates that output is written at the exact times dictated by the specified number of intervals. The default value is OFF.

  • boltLoad (str, default: '') – A String specifying a bolt load from which output is requested.

  • sectionPoints (Union[Literal[DEFAULT], Tuple[int, ...]], default: DEFAULT) – The SymbolicConstant DEFAULT or a sequence of Ints specifying the section points for which output requested. The default is DEFAULT.

  • interactions (Optional[str], default: None) – None or a sequence of Strings specifying the interaction names. The default value is None.The sequence can contain only one String.

  • rebar (Literal[EXCLUDE, INCLUDE, ONLY], default: EXCLUDE) – A SymbolicConstant specifying whether output is requested for rebar. Possible values are EXCLUDE, INCLUDE, and ONLY. The default value is EXCLUDE.

  • filter (Optional[SymbolicConstant], default: None) – The SymbolicConstant ANTIALIASING or a String specifying the name of an output filter object. The default value is None.

  • directions (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to output directions of the local material coordinate system. The default value is ON.

  • fasteners (str, default: '') – A String specifying the fastener name. The default value is an empty string.

  • assembledFastener (str, default: '') – A String specifying the assembled fastener name. The default value is an empty string.

  • assembledFastenerSet (str, default: '') – A String specifying the set name from the model referenced by the assembled fastener, assembledFastener. The default value is an empty string.

  • exteriorOnly (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the output domain is restricted to the exterior of the model. This argument is only valid if region = MODEL. The default value is OFF.

  • layupNames (str, default: '') – A List of Composite Layer Names.

  • layupLocationMethod (str, default: SPECIFIED) – A Symbolic constant specifying the method used to indicate the output locations for composite layups. Possible values are ALL_LOCATIONS, SPECIFIED and TYPED_IN. The default value is SPECIFIED.

  • outputAtPlyTop (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to output at the ply top section point. The default value is False.

  • outputAtPlyMid (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to output at the ply mid section point. The default value is True.

  • outputAtPlyBottom (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to output at the ply bottom section point. The default value is False.

  • position (Literal[INTEGRATION_POINTS, AVERAGED_AT_NODES, CENTROIDAL, NODES], default: INTEGRATION_POINTS) – A SymbolicConstant specifying the position on an element where output needs to be written. Possible values are INTEGRATION_POINTS, AVERAGED_AT_NODES, CENTROIDAL, and NODES. The default value is INTEGRATION_POINTS.

Returns:

A FieldOutputRequest object.

Return type:

FieldOutputRequest

FilmCondition(name, createStepName, surface, definition, interactionProperty='', sinkTemperature=0, sinkAmplitude='', filmCoeff=0, filmCoeffAmplitude='', field='', sinkFieldName='', sinkDistributionType=abaqusConstants.UNIFORM)[source]#

This method creates a FilmCondition object.

Note

This function can be accessed by:

mdb.models[name].FilmCondition

Note

Check FilmCondition on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the FilmCondition object is created.

  • surface (Region) – A Region object specifying the name of the surface to which the film condition interaction is applied.

  • definition (SymbolicConstant) – A SymbolicConstant specifying how the film condition is defined. Possible values are EMBEDDED_COEFF, PROPERTY_REF, USER_SUB, and FIELD.

  • interactionProperty (str, default: '') – A String specifying the name of the FilmConditionProp object associated with this interaction. The interactionProperty argument applies only when definition = PROPERTY_REF. The default value is an empty string.

  • sinkTemperature (float, default: 0) – A Float specifying the reference sink temperature, θ0θ0. The default value is 0.0.

  • sinkAmplitude (str, default: '') – A String specifying the name of the Amplitude object that gives the variation of the sink temperature, θ0θ0, with time. The default value is an empty string.Note:Use empty string in an Abaqus/Standard analysis to specify that the reference sink temperature is applied immediately at the beginning of the step or linearly over the step. Use empty string in an Abaqus/Explicit analysis to specify that the reference sink temperature is applied throughout the step.

  • filmCoeff (float, default: 0) – A Float specifying the reference film coefficient value, hh. The filmCoeff argument applies when definition = EMBEDDED_COEFF, definition = USER_SUB, or definition = FIELD. The default value is 0.0.

  • filmCoeffAmplitude (str, default: '') – A String specifying the name of the Amplitude object that gives the variation of the film coefficient, hh, with time. The default value is an empty string. Note: Use empty string in an Abaqus/Standard analysis to specify that the reference film coefficient is applied immediately at the beginning of the step or linearly over the step. Use empty string in an Abaqus/Explicit analysis to specify that the reference film coefficient is applied throughout the step.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when definition = FIELD. The default value is an empty string.

  • sinkFieldName (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object associated with the sink temperature. The sinkFieldName argument applies only when sinkDistributionType = ANALYTICAL_FIELD or sinkDistributionType = DISCRETE_FIELD. The default value is an empty string.

  • sinkDistributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the sink temperature is distributed. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

Returns:

A FilmCondition object.

Return type:

FilmCondition

FilmConditionProp(name, temperatureDependency=OFF, dependencies=0, property=())[source]#

This method creates a FilmConditionProp object.

Note

This function can be accessed by:

mdb.models[name].FilmConditionProp

Note

Check FilmConditionProp on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • property (tuple, default: ()) –

    A sequence of sequences of Floats specifying the following:

    • The film coefficient, hh.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

Returns:

A FilmConditionProp object.

Return type:

FilmConditionProp

FluidCavity(name, createStepName, cavityPoint, cavitySurface, interactionProperty, ambientPressure=0, thickness=1, useAdiabatic=OFF, checkNormals=ON)[source]#

This method creates an FluidCavity object.

Note

This function can be accessed by:

mdb.models[name].FluidCavity

Note

Check FluidCavity on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the FluidCavity object is created.

  • cavityPoint (Region) – A Region object specifying the fluid cavity reference point.

  • cavitySurface (Region) – A Region object specifying the surface forming the boundary of the fluid cavity.

  • interactionProperty (str) – A String specifying the FluidCavityProperty object associated with this interaction.

  • ambientPressure (float, default: 0) – A Float specifying the magnitude of the ambient pressure. The default value is 0.0.

  • thickness (float, default: 1) – A Float specifying the out-of-plane thickness of the surface for two-dimensional models. This argument is valid only when using two-dimensional models. The default value is 1.0.

  • useAdiabatic (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether adiabatic behavior is assumed for the ideal gas. This argument is valid only when interactionProperty specifies a pneumatic definition. The default value is OFF.

  • checkNormals (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the analysis will check the consistency of the surface normals. The default value is ON.

Returns:

A FluidCavity object.

Return type:

FluidCavity

FluidCavityPressure(name, fluidCavity, fluidPressure)[source]#

This method creates a FluidCavityPressure object.

Note

This function can be accessed by:

mdb.models[name].FluidCavityPressure

Note

Check FluidCavityPressure on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • fluidCavity (str) – A String specifying the name of a Fluid Cavity Interaction.

  • fluidPressure (float) – A Float specifying the initial fluid pressure.

Returns:

A FluidCavityPressure object.

Return type:

FluidCavityPressure

FluidCavityPressureBC(name, createStepName, fluidCavity, magnitude=0, amplitude=abaqusConstants.UNSET, fixed=OFF)[source]#

This method creates a FluidCavityPressureBC object.

Note

This function can be accessed by:

mdb.models[name].FluidCavityPressureBC

Note

Check FluidCavityPressureBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • fluidCavity (str) – A String specifying the name of a Fluid Cavity Interaction.

  • magnitude (float, default: 0) – A Float specifying the fluid cavity pressure magnitude. The default value is 0.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A FluidCavityPressureBC object.

Return type:

FluidCavityPressureBC

FluidCavityProperty(name, definition=abaqusConstants.HYDRAULIC, fluidDensity=None, molecularWeight=None, useExpansion=OFF, expansionTempDep=OFF, expansionDependencies=0, referenceTemperature=0, expansionTable=(), useBulkModulus=OFF, bulkModulusTempDep=OFF, bulkModulusDependencies=0, bulkModulusTable=(), useCapacity=OFF, capacityType=abaqusConstants.POLYNOMIAL, capacityTempDep=OFF, capacityDependencies=0, capacityTable=())[source]#

This method creates a FluidCavityProperty object.

Note

This function can be accessed by:

mdb.models[name].FluidCavityProperty

Note

Check FluidCavityProperty on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • definition (SymbolicConstant, default: HYDRAULIC) – A SymbolicConstant specifying the type of fluid cavity property to be defined. Possible values are HYDRAULIC and PNEUMATIC. The default value is HYDRAULIC.

  • fluidDensity (Optional[float], default: None) – None or a Float specifying the reference fluid density. This argument is applicable only when definition = HYDRAULIC, and is required in that case. The default value is None.

  • molecularWeight (Optional[float], default: None) – None or a Float specifying the molecular weight of the ideal gas species. This argument is applicable only when definition = PNEUMATIC, and is required in that case. The default value is None.

  • useExpansion (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether thermal expansion coefficients will be defined. This argument is applicable only when definition = HYDRAULIC. The default value is OFF.

  • expansionTempDep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the thermal fluid expansion data will have temperature dependency. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. The default value is OFF.

  • expansionDependencies (int, default: 0) – An Int specifying the number of field variable dependencies in the thermal fluid expansion data. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. The default value is 0.

  • referenceTemperature (float, default: 0) – A Float specifying the reference temperature for the coefficient of thermal expansion. This argument is applicable only when definition = HYDRAULIC, when useExpansion = True, and when either expansionTempDep = True or when expansionDependencies is greater than 0. The default value is 0.0.

  • expansionTable (tuple, default: ()) –

    A sequence of sequences of Floats specifying the thermal expansion coefficients. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. Each sequence contains the following data:

    • The mean coefficient of thermal expansion.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • useBulkModulus (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether fluid bulk modulus values will be defined. This argument is applicable only when definition = HYDRAULIC. The default value is OFF.

  • bulkModulusTempDep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the fluid bulk modulus data will have temperature dependency. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. The default value is OFF.

  • bulkModulusDependencies (int, default: 0) – An Int specifying the number of field variable dependencies in the fluid bulk modulus data. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. The default value is 0.

  • bulkModulusTable (tuple, default: ()) –

    A sequence of sequences of Floats specifying the fluid bulk modulus values. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. Each sequence contains the following data:

    • The fluid bulk modulus.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • useCapacity (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether molar heat capacity values will be defined. This argument is applicable only when definition = PNEUMATIC. The default value is OFF.

  • capacityType (SymbolicConstant, default: POLYNOMIAL) – A SymbolicConstant specifying the method to define the molar heat capacity. Possible values are POLYNOMIAL and TABULAR. The default value is POLYNOMIAL.

  • capacityTempDep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the molar heat capacity data will have temperature dependency. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. The default value is OFF.

  • capacityDependencies (int, default: 0) – An Int specifying the number of field variable dependencies in the molar heat capacity data. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. The default value is 0.

  • capacityTable (tuple, default: ()) –

    A sequence of sequences of Floats specifying the molar heat capacity values in the form of a polynomial expression. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = POLYNOMIAL. In this form, only one sequence is specified and that sequence contains the following data:

    • The first molar heat capacity coefficient.

    • The second molar heat capacity coefficient.

    • The third molar heat capacity coefficient.

    • The fourth molar heat capacity coefficient.

    • The fifth molar heat capacity coefficient.

    Alternatively, the sequence data may specify the molar heat capacity values at constant pressure for an ideal gas species. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. Each sequence contains the following data:

    • The molar heat capacity at constant pressure.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

Returns:

A FluidCavityProperty object.

Return type:

FluidCavityProperty

FluidExchange(name, createStepName, firstCavity, interactionProperty, definition=abaqusConstants.TO_ENVIRONMENT, secondCavity='', exchangeArea=1)[source]#

This method creates an FluidExchange object.

Note

This function can be accessed by:

mdb.models[name].FluidExchange

Note

Check FluidExchange on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the FluidExchange object is created.

  • firstCavity (str) – A String specifying the first FluidCavity object associated with this interaction. This will be the only cavity specified if definition = TO_ENVIRONMENT.

  • interactionProperty (str) – A String specifying the FluidExchangeProperty object associated with this interaction.

  • definition (SymbolicConstant, default: TO_ENVIRONMENT) – A SymbolicConstant specifying the type of fluid exchange to be defined. Possible values are TO_ENVIRONMENT and BETWEEN_CAVITIES. The default value is TO_ENVIRONMENT.

  • secondCavity (str, default: '') – A String specifying the second FluidCavity object associated with this interaction. This argument is applicable only when definition = BETWEEN_CAVITIES.

  • exchangeArea (float, default: 1) – A Float specifying the effective exchange area. The default value is 1.0.

Returns:

A FluidExchange object.

Return type:

FluidExchange

FluidExchangeProperty(name, dataTable, definition=abaqusConstants.BULK_VISCOSITY, pressureDependency=OFF, temperatureDependency=OFF, fieldDependencies=0)[source]#

This method creates a FluidExchangeProperty object.

Note

This function can be accessed by:

mdb.models[name].FluidExchangeProperty

Note

Check FluidExchangeProperty on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • dataTable (tuple) –

    A sequence of sequences of Floats specifying the viscous and hydrodynamic resistance coefficients when definition = BULK_VISCOSITY. Each sequence contains the following data:

    • The viscous resistance coefficient.

    • The hydrodynamic resistance coefficient.

    • The average absolute pressure, if the data depend on pressure.

    • The average temperature, if the data depend on temperature.

    • The value of the first field variable, if the data depend on field variables.

    • The value of the second field variable.

    • Etc.

    Alternatively, the sequence data may specify the mass flow rate. This is applicable only when definition = MASS_FLUX. In this form, only one sequence is specified and that sequence contains the following data:

    • The mass flow rate per unit area.

    Alternatively, the sequence data may specify the mass rate leakage. This is applicable only when definition = MASS_RATE_LEAK. Each sequence contains the following data:

    • The absolute value of the mass flow rate per unit area. (The first tabular value entered must always be zero.)

    • The absolute value of the pressure difference. (The first tabular value entered must always be zero.)

    • The average absolute pressure, if the data depend on pressure.

    • The average temperature, if the data depend on temperature.

    • The value of the first field variable, if the data depend on field variables.

    • The value of the second field variable.

    • Etc.

    Alternatively, the sequence data may specify the volume flow rate. This is applicable only when definition = VOL_FLUX. In this form, only one sequence is specified and that sequence contains the following data:

    • The volumetric flow rate per unit area.

    Alternatively, the sequence data may specify the volume rate leakage. This is applicable only when definition = VOL_RATE_LEAK. Each sequence contains the following data:

    • The absolute value of the volumetric flow rate per unit area. (The first tabular value entered must always be zero.)

    • The absolute value of the pressure difference. (The first tabular value entered must always be zero.)

    • The average absolute pressure, if the data depend on pressure.

    • The average temperature, if the data depend on temperature.

    • The value of the first field variable, if the data depend on field variables.

    • The value of the second field variable.

    • Etc.

  • definition (SymbolicConstant, default: BULK_VISCOSITY) – A SymbolicConstant specifying the type of fluid exchange property to be defined. Possible values are BULK_VISCOSITY, MASS_FLUX, MASS_RATE_LEAK, VOL_FLUX, and VOL_RATE_LEAK. The default value is BULK_VISCOSITY.

  • pressureDependency (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the data will have pressure dependency. This argument is applicable only when definition = BULK_VISCOSITY, or when definition = MASS_RATE_LEAK, or when definition = VOL_RATE_LEAK. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the data will have temperature dependency. This argument is applicable only when definition = BULK_VISCOSITY, or when definition = MASS_RATE_LEAK, or when definition = VOL_RATE_LEAK. The default value is OFF.

  • fieldDependencies (int, default: 0) – An Int specifying the number of field variable dependencies in the data. This argument is applicable only when definition = BULK_VISCOSITY, or when definition = MASS_RATE_LEAK, or when definition = VOL_RATE_LEAK. The default value is 0.

Returns:

A FluidExchangeProperty object.

Return type:

FluidExchangeProperty

FluidInflator(name, createStepName, cavity, interactionProperty, inflationTimeAmplitude='', massFlowAmplitude='')[source]#

This method creates a FluidInflator object.

Note

This function can be accessed by:

mdb.models[name].FluidInflator

New in version 2019: The FluidInflator method was added.

Note

Check FluidInflator on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the FluidInflator object is created.

  • cavity (str) – A String specifying the first FluidCavity object associated with this interaction.

  • interactionProperty (str) – A String specifying the FluidInflatorProperty object associated with this interaction.

  • inflationTimeAmplitude (str, default: '') – A string specifying the name of the amplitude curve defining a mapping between the inflation time and the actual time.

  • massFlowAmplitude (str, default: '') – A string specifying the name of the amplitude curve by which to modify the mass flow rate.

Return type:

A FluidInflator object.

FluidInflatorProperty(name, definition, effectiveArea, tankVolume, dischargeCoefficient=None, dataTable=(), numFluids=None, mixtureType='', inflationTime=(), fluidbehaviorName=(), massFraction=())[source]#

This method creates a FluidInflatorProperty object.

Note

This function can be accessed by:

mdb.models[name].FluidInflatorProperty

New in version 2019: The FluidInflatorProperty method was added.

Note

Check FluidInflatorProperty on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • definition (str) – A Symbolic constant specifying the method used for modeling the flow characteristics of inflators. The default value is definition = DUAL PRESSURE. The possible values are DUAL PRESSURE, PRESSURE AND MASS, TANK TEST, and TEMPERATURE AND MASS.

  • effectiveArea (float) – A Float specifying the total inflator orifice area. This argument is applicable only if definition = DUAL PRESSURE or definition = PRESSURE AND MASS.

  • tankVolume (float) – A Float specifying the tank volume. This argument is applicable only if definition = DUAL PRESSURE or definition = TANK TEST.

  • dischargeCoefficient (Optional[float], default: None) – A Float specifying the discharge coefficient. This argument is applicable only if definition = DUAL PRESSURE or definition = PRESSURE AND MASS.

  • dataTable (tuple, default: ()) – A sequence of sequences of Floats specifying the items described in the “Table data” section below.

  • numFluids (Optional[int], default: None) – An Int specifying the number of gas species used for this inflator.

  • mixtureType (str, default: '') – A Symbolic constant specifying whether to use mass fraction or the molar fraction for a mixture of ideal gases. The default value is MASS FRACTION. The possible values are MASS FRACTION or MOLAR FRACTION.

  • inflationTime (tuple, default: ()) – A sequence of sequences of Floats specifying the inflation time.

  • fluidbehaviorName (tuple, default: ()) – A sequence of sequences of Strings specifying fluid behavior names.

  • massFraction (tuple, default: ()) – A sequence of sequences of Floats specifying the mass fraction or the molar fraction corresponding to entered fluid behavior.

Return type:

A FluidInflatorProperty object.

FrequencyStep(name, previous, eigensolver, numEigen=abaqusConstants.ALL, description='', shift=0, minEigen=None, maxEigen=None, vectors=None, maxIterations=30, blockSize=abaqusConstants.DEFAULT, maxBlocks=abaqusConstants.DEFAULT, normalization=abaqusConstants.DISPLACEMENT, propertyEvaluationFrequency=None, projectDamping=ON, acousticCoupling=abaqusConstants.AC_ON, acousticRangeFactor=1, frictionDamping=OFF, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False, simLinearDynamics=OFF, residualModes=OFF, substructureCutoffMultiplier=5, firstCutoffMultiplier=1, secondCutoffMultiplier=1, residualModeRegion=None, residualModeDof=None, limitSavedEigenvectorRegion=None)[source]#

This method creates a FrequencyStep object.

Note

This function can be accessed by:

mdb.models[name].FrequencyStep

Note

Check FrequencyStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • eigensolver (SymbolicConstant) – A SymbolicConstant specifying the eigensolver. Possible values are LANCZOS, SUBSPACE, and AMS.The following optional arguments are ignored unless eigensolver = LANCZOS: blockSize, maxBlocks, normalization, propertyEvaluationFrequency.The following optional arguments are ignored unless eigensolver = LANCZOS or AMS: minEigen, maxEigen, and acousticCoupling.The following optional arguments are ignored unless eigensolver = AMS: projectDamping, acousticRangeFactor, substructureCutoffMultiplier, firstCutoffMultiplier, secondCutoffMultiplier, residualModeRegion, regionalModeDof, and limitSavedEigenvectorRegion.

  • numEigen (SymbolicConstant, default: ALL) – The SymbolicConstant ALL or an Int specifying the number of eigenvalues to be calculated or ALL. The default value is ALL.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • shift (float, default: 0) – A Float specifying the shift point in cycles per time. The default value is 0.0.

  • minEigen (Optional[float], default: None) – None or a Float specifying the minimum frequency of interest in cycles per time. The default value is None.

  • maxEigen (Optional[float], default: None) – None or a Float specifying the maximum frequency of interest in cycles per time. The default value is None.

  • vectors (Optional[int], default: None) – None or an Int specifying the number of vectors used in the iteration. The default is the minimum of (2*n*, n + 8), where n is the number of eigenvalues requested. The default value is None.

  • maxIterations (int, default: 30) – An Int specifying the maximum number of iterations. The default value is 30.

  • blockSize (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the size of the Lanczos block steps. The default value is DEFAULT.

  • maxBlocks (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the maximum number of Lanczos block steps within each Lanczos run. The default value is DEFAULT.

  • normalization (SymbolicConstant, default: DISPLACEMENT) – A SymbolicConstant specifying the method for normalizing eigenvectors. Possible values are DISPLACEMENT and MASS. The default value is DISPLACEMENT.A value of DISPLACEMENT indicates normalizing the eigenvectors so that the largest displacement entry in each vector is unity. A value of MASS indicates normalizing the eigenvectors with respect to the structure’s mass matrix, which results in scaling the eigenvectors so that the generalized mass for each vector is unity.

  • propertyEvaluationFrequency (Optional[float], default: None) – None or a Float specifying the frequency at which to evaluate frequency-dependent properties for viscoelasticity, springs, and dashpots during the eigenvalue extraction. If the value is None, the analysis product will evaluate the stiffness associated with frequency-dependent springs and dashpots at zero frequency and will not consider the stiffness contributions from frequency-domain viscoelasticity in the step. The default value is None.

  • projectDamping (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include projection of viscous and structural damping operators during AMS eigenvalue extraction. Valid only when eigenSolver = AMS. The default value is ON.

  • acousticCoupling (SymbolicConstant, default: AC_ON) – A SymbolicConstant specifying the type of acoustic-structural coupling in models with acoustic and structural elements coupled using the TIE option or in models with ASI-type elements. Possible values are AC_ON, AC_OFF, and AC_PROJECTION. The default value is AC_ON.

  • acousticRangeFactor (float, default: 1) – A Float specifying the ratio of the maximum acoustic frequency to the maximum structural frequency. The default value is 1.0.

  • frictionDamping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • simLinearDynamics (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to activate the SIM-based linear dynamics procedures. The default value is OFF.

  • residualModes (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include residual modes from an immediately preceding Static, Linear Perturbation step. The default value is OFF.

  • substructureCutoffMultiplier (float, default: 5) – A Float specifying the cutoff frequency for substructure eigenproblems, defined as a multiplier of the maximum frequency of interest. The default value is 5.0.

  • firstCutoffMultiplier (float, default: 1) – A Float specifying the first cutoff frequency for a reduced eigenproblem, defined as a multiplier of the maximum frequency of interest. The default value is 1.7.

  • secondCutoffMultiplier (float, default: 1) – A Float specifying the second cutoff frequency for a reduced eigenproblem defined as a multiplier of the maximum frequency of interest. The default value is 1.1.

  • residualModeRegion (Optional[str], default: None) – None or a sequence of Strings specifying the name of a region for which residual modes are requested. The default value is None.

  • residualModeDof (Optional[str], default: None) – None or a sequence of Ints specifying the degree of freedom for which residual modes are requested. The default value is None.

  • limitSavedEigenvectorRegion (Optional[SymbolicConstant], default: None) – None or a Region object specifying a region for which eigenvectors should be saved or the SymbolicConstant None representing the whole model. The default value is None.

Returns:

step – A FrequencyStep object.

Return type:

FrequencyStep

GasketSection(name, material, crossSection=1, initialGap=0, initialThickness=abaqusConstants.DEFAULT, initialVoid=0, stabilizationStiffness=abaqusConstants.DEFAULT)[source]#

This method creates a GasketSection object.

Note

This function can be accessed by:

mdb.models[name].GasketSection
session.odbs[name].GasketSection

Note

Check GasketSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • material (str) – A String specifying the name of the material of which the gasket is made or material that defines gasket behavior.

  • crossSection (float, default: 1) – A Float specifying the cross-sectional area, width, or out-of-plane thickness, if applicable, depending on the gasket element type. The default value is 1.0.

  • initialGap (float, default: 0) – A Float specifying the initial gap. The default value is 0.0.

  • initialThickness (Union[Literal[DEFAULT], float], default: DEFAULT) – The SymbolicConstant DEFAULT or a Float specifying the initial gasket thickness. If DEFAULT is specified, the initial thickness is determined using nodal coordinates. The default value is DEFAULT.

  • initialVoid (float, default: 0) – A Float specifying the initial void. The default value is 0.0.

  • stabilizationStiffness (Union[Literal[DEFAULT], float], default: DEFAULT) – The SymbolicConstant DEFAULT or a Float specifying the default stabilization stiffness used in all but link elements to stabilize gasket elements that are not supported at all nodes, such as those that extend outside neighboring components. If DEFAULT is specified, a value is used equal to 10-9 times the initial compressive stiffness in the thickness direction. The default value is DEFAULT.

Returns:

A GasketSection object. and ValueError.

Return type:

GasketSection

GeneralStiffnessSection(name, stiffnessMatrix, referenceTemperature=None, applyThermalStress=OFF, temperatureDependency=OFF, dependencies=0, poissonDefinition=abaqusConstants.DEFAULT, poisson=0, useDensity=OFF, density=0, thermalStresses=(), scalingData=())[source]#

This method creates a GeneralStiffnessSection object.

Note

This function can be accessed by:

mdb.models[name].GeneralStiffnessSection
session.odbs[name].GeneralStiffnessSection

Note

Check GeneralStiffnessSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • stiffnessMatrix (tuple) – A sequence of Floats specifying the stiffness matrix for the section in the order D11, D12, D22, D13, D23, D33, …., D66. Twenty-one entries must be given.

  • referenceTemperature (Optional[float], default: None) – None or a Float specifying the reference temperature for thermal expansion. The default value is None.

  • applyThermalStress (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not the section stiffness varies with thermal stresses. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • poissonDefinition (Literal[VALUE, DEFAULT], default: DEFAULT) – A SymbolicConstant specifying whether to use the default value for the Poisson’s ratio. Possible values are:DEFAULT, specifying that the default value for the Poisson’s ratio is 0.5 in an Abaqus/Standard analysis and is obtained from the material definition in an Abaqus/Explicit analysis.VALUE, specifying that the Poisson’s ratio used in the analysis is the value provided in poisson.The default value is DEFAULT.

  • poisson (float, default: 0) – A Float specifying the Poisson’s ratio. Possible values are −1.0 ≤ poisson ≤ 0.5. This argument is valid only when poissonDefinition = VALUE. The default value is 0.5.

  • useDensity (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not to use the value of density. The default value is OFF.

  • density (float, default: 0) – A Float specifying the value of density to apply to this section. The default value is 0.0.

  • thermalStresses (tuple, default: ()) – A sequence of Floats specifying the generalized stress values caused by a unit temperature rise. Six entries must be given if the value of applyThermalStress is set to True. The default value is (“”).

  • scalingData (tuple, default: ()) – A sequence of sequences of Floats specifying the scaling factors for given temperatures and/or field data. Each row should contain (Y, alpha, T, F1,…,Fn). The default value is an empty sequence.

Returns:

A GeneralStiffnessSection object.

Return type:

GeneralStiffnessSection

GeneralizedProfile(name, area, i11, i12, i22, j, gammaO, gammaW)[source]#

This method creates a GeneralizedProfile object.

Note

This function can be accessed by:

mdb.models[name].GeneralizedProfile
session.odbs[name].GeneralizedProfile

Note

Check GeneralizedProfile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • area (float) – A Float specifying the cross-sectional area for the profile.

  • i11 (float) – A Float specifying the moment of inertia for bending about the 1-axis, I11I11.

  • i12 (float) – A Float specifying the moment of inertia for cross bending, I12I12.

  • i22 (float) – A Float specifying the moment of inertia for bending about the 2-axis, I22I22.

  • j (float) – A Float specifying the torsional constant, JJ.

  • gammaO (float) – A Float specifying the sectorial moment, Γ0Γ0.

  • gammaW (float) – A Float specifying the warping constant, ΓWΓW.

Returns:

A GeneralizedProfile object.

Return type:

GeneralizedProfile

Raises:

RangeError –

GeostaticStep(name, previous, description='', nlgeom=OFF, matrixSolver=abaqusConstants.DIRECT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False, solutionTechnique=abaqusConstants.FULL_NEWTON, reformKernel=8, convertSDI=abaqusConstants.PROPAGATED, utol=None, timePeriod=1, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None)[source]#

This method creates a GeostaticStep object.

Note

This function can be accessed by:

mdb.models[name].GeostaticStep

Note

Check GeostaticStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.

  • matrixSolver (SymbolicConstant, default: DIRECT) – A SymbolicConstant specifying the type of solver. Possible values are DIRECT and ITERATIVE. The default value is DIRECT.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the technique used to for solving nonlinear equations. Possible values are FULL_NEWTON and QUASI_NEWTON. The default value is FULL_NEWTON.

  • reformKernel (int, default: 8) – An Int specifying the number of quasi-Newton iterations allowed before the kernel matrix is reformed.. The default value is 8.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

  • utol (Optional[float], default: None) – None or a Float specifying the tolerance for maximum change of displacements. The default value is None.

  • timePeriod (float, default: 1) – A Float specifying the total time period. The default value is 1.0.Note:This parameter is ignored unless timeIncrementationMethod = AUTOMATIC.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) –

    An Int specifying the maximum number of increments in a step. The default value is 100.

    New in version 2017: The maxNumInc attribute was added to the GeostaticStep class.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.Note:This parameter is ignored unless timeIncrementationMethod = AUTOMATIC.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.Note:This parameter is ignored unless timeIncrementationMethod = AUTOMATIC.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.Note:This parameter is ignored unless timeIncrementationMethod = AUTOMATIC.

Returns:

step – A GeostaticStep object.

Return type:

GeostaticStep

Gravity(name, createStepName, distributionType=abaqusConstants.UNIFORM, field='', region=None, comp1=None, comp2=None, comp3=None, amplitude=abaqusConstants.UNSET)[source]#

This method creates a Gravity object.

Note

This function can be accessed by:

mdb.models[name].Gravity

Note

Check Gravity on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • region (Optional[Region], default: None) – A Region object specifying the region to which the load is applied.

  • comp1 (Optional[float], default: None) – A Float or a Complex specifying the component of the load in the 1-direction.Note:Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero.

  • comp2 (Optional[float], default: None) – A Float or a Complex specifying the component of the load in the 2-direction.

  • comp3 (Optional[float], default: None) – A Float or a Complex specifying the component of the load in the 3-direction.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A Gravity object.

Return type:

Gravity

HeatTransferStep(name, previous, description='', response=abaqusConstants.TRANSIENT, timePeriod=1, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None, end=None, deltmx=0, mxdem=0, amplitude=abaqusConstants.STEP, extrapolation=abaqusConstants.LINEAR, matrixSolver=abaqusConstants.DIRECT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False, solutionTechnique=abaqusConstants.FULL_NEWTON, reformKernel=8, convertSDI=abaqusConstants.PROPAGATED)[source]#

This method creates a HeatTransferStep object.

Note

This function can be accessed by:

mdb.models[name].HeatTransferStep

Note

Check HeatTransferStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • response (SymbolicConstant, default: TRANSIENT) – A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

  • timePeriod (float, default: 1) – A Float specifying the total time period. The default value is 1.0.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of 0.8 times the initial time increment or 10−5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • end (Optional[float], default: None) – None or a Float specifying the temperature change rate (temperature per time) used to define steady state. When all nodal temperatures are changing at less than this rate, the solution terminates. The default value is None.Note:This parameter is ignored unless response = STEADY_STATE.

  • deltmx (float, default: 0) – A Float specifying the maximum temperature change to be allowed in an increment during a transient heat transfer analysis. The default value is 0.0.

  • mxdem (float, default: 0) – A Float specifying the maximum allowable emissivity change with temperature and field variables during an increment. The default value is 0.1.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default is STEP. Possible values are STEP and RAMP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • matrixSolver (SymbolicConstant, default: DIRECT) – A SymbolicConstant specifying the type of solver. Possible values are DIRECT and ITERATIVE. The default value is DIRECT.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the technique used to for solving nonlinear equations. Possible values are FULL_NEWTON and QUASI_NEWTON. The default value is FULL_NEWTON.

  • reformKernel (int, default: 8) – An Int specifying the number of quasi-Newton iterations allowed before the kernel matrix is reformed.. The default value is 8.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

Returns:

step – A HeatTransferStep object.

Return type:

HeatTransferStep

HexagonalProfile(name, r, t)[source]#

This method creates a HexagonalProfile object.

Note

This function can be accessed by:

mdb.models[name].HexagonalProfile
session.odbs[name].HexagonalProfile

Note

Check HexagonalProfile on help.3ds.com/2021.

Parameters:
Returns:

A HexagonalProfile object.

Return type:

HexagonalProfile

Raises:

RangeError –

HistoryOutputRequest(name, createStepName, region=abaqusConstants.MODEL, variables=abaqusConstants.PRESELECT, frequency=1, modes=abaqusConstants.ALL, timeInterval=abaqusConstants.EVERY_TIME_INCREMENT, numIntervals=20, boltLoad='', sectionPoints=abaqusConstants.DEFAULT, stepName='', interactions=None, contourIntegral=None, numberOfContours=0, stressInitializationStep=None, contourType=abaqusConstants.J_INTEGRAL, kFactorDirection=abaqusConstants.MTS, rebar=abaqusConstants.EXCLUDE, integratedOutputSection='', springs=None, filter=None, fasteners='', assembledFastener='', assembledFastenerSet='', sensor=OFF, useGlobal=True)[source]#

This method creates a HistoryOutputRequest object.

Note

This function can be accessed by:

mdb.models[name].HistoryOutputRequest

Note

Check HistoryOutputRequest on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the object is created.

  • region (Union[Literal[MODEL], Region], default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region from which output is requested. The SymbolicConstant MODEL represents the whole model. The default value is MODEL. If the region is a surface region, the surface must lie within the general contact surface domain.

  • variables (Union[Tuple[str, ...], Literal[PRESELECT, ALL]], default: PRESELECT) – A sequence of Strings specifying output request variable or component names, or the SymbolicConstant PRESELECT or ALL. PRESELECT represents all default output variables for the given step. ALL represents all valid output variables. The default value is PRESELECT.

  • frequency (Union[int, Literal[LAST_INCREMENT]], default: 1) – The SymbolicConstant LAST_INCREMENT or an Int specifying the output frequency in increments. The default value is 1.

  • modes (Union[Literal[ALL], Tuple[int, ...]], default: ALL) – The SymbolicConstant ALL or a sequence of Ints specifying a list of eigenmodes for which output is desired. The default value is ALL.

  • timeInterval (Union[Literal[EVERY_TIME_INCREMENT], float], default: EVERY_TIME_INCREMENT) – The SymbolicConstant EVERY_TIME_INCREMENT or a Float specifying the time interval at which the output states are to be written. The default value is EVERY_TIME_INCREMENT.

  • numIntervals (int, default: 20) – An Int specifying the number of intervals during the step at which output database states are to be written. The default value is 20.

  • boltLoad (str, default: '') – A String specifying a bolt load from which output is requested. The default value is an empty string.

  • sectionPoints (Union[Literal[DEFAULT], Tuple[int, ...]], default: DEFAULT) – The SymbolicConstant DEFAULT or a sequence of Ints specifying the section points for which output is requested. The default value is DEFAULT.

  • stepName (str, default: '') – A String specifying the name of the step. The default value is an empty string.

  • interactions (Optional[str], default: None) – None or a sequence of Strings specifying the interaction names. The default value is None.The sequence can contain only one String.

  • contourIntegral (Optional[str], default: None) – A String specifying the contour integral name. The default value is None.

  • numberOfContours (int, default: 0) – An Int specifying the number of contour integrals to output for the contour integral object. The default value is 0.

  • stressInitializationStep (Optional[str], default: None) – A String specifying the name of the stress initialization step. The default value is None.

  • contourType (Literal[J_INTEGRAL, C_INTEGRAL, T_STRESS, K_FACTORS], default: J_INTEGRAL) – A SymbolicConstant specifying the type of contour integral. Possible values are J_INTEGRAL, C_INTEGRAL, T_STRESS, and K_FACTORS. The default value is J_INTEGRAL.

  • kFactorDirection (Literal[MTS, MERR, K110], default: MTS) – A SymbolicConstant specifying the stress intensity factor direction. Possible values are MTS, MERR, and K110. The kFactorDirection argument is valid only if contourType = K_FACTORS. The default value is MTS.

  • rebar (Literal[EXCLUDE, INCLUDE, ONLY], default: EXCLUDE) – A SymbolicConstant specifying whether output is requested for rebar. Possible values are EXCLUDE, INCLUDE, and ONLY. The default value is EXCLUDE.

  • integratedOutputSection (str, default: '') – A String specifying the integrated output section. The default value is an empty string.

  • springs (Optional[tuple], default: None) – A sequence of Strings specifying the springs/dashpots names. The default value is None. The sequence can contain only one String.

  • filter (Optional[SymbolicConstant], default: None) – The SymbolicConstant ANTIALIASING or a String specifying the name of an output filter object. The default value is None.

  • fasteners (str, default: '') – A String specifying the fastener name. The default value is an empty string.

  • assembledFastener (str, default: '') – A String specifying the assembled fastener name. The default value is an empty string.

  • assembledFastenerSet (str, default: '') – A String specifying the set name from the model referenced by the assembled fastener, assembledFastener. The default value is an empty string.

  • sensor (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to associate the output request with a sensor definition. The default value is OFF.

  • useGlobal (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to output vector-valued nodal variables in the global directions. The default value is True.

Returns:

A HistoryOutputRequest object.

Return type:

HistoryOutputRequest

HomogeneousShellSection(name, material, thickness=0, numIntPts=5, thicknessType=abaqusConstants.UNIFORM, preIntegrate=OFF, poissonDefinition=abaqusConstants.DEFAULT, poisson=0, integrationRule=abaqusConstants.SIMPSON, temperature=abaqusConstants.GRADIENT, idealization=abaqusConstants.NO_IDEALIZATION, nTemp=None, thicknessModulus=None, useDensity=OFF, density=0, thicknessField='', nodalThicknessField='')[source]#

This method creates a HomogeneousShellSection object.

Note

This function can be accessed by:

mdb.models[name].parts[name].compositeLayups[i].HomogeneousShellSection
mdb.models[name].HomogeneousShellSection
session.odbs[name].HomogeneousShellSection

Note

Check HomogeneousShellSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • material (str) – A String specifying the name of the section material.

  • thickness (float, default: 0) – A Float specifying the thickness of the section. The thickness argument applies only when thicknessType = UNIFORM. The default value is 0.0.

  • numIntPts (int, default: 5) – An Int specifying the number of integration points to be used through the section. Possible values are numIntPts >> 0. The default value is 5.To use the default settings of the analysis products, set numIntPts to 5 if integrationRule = SIMPSON or set numIntPts to 7 if integrationRule = GAUSS.

  • thicknessType (Literal[UNIFORM, ANALYTICAL_FIELD, DISCRETE_FIELD, NODAL_ANALYTICAL_FIELD, NODAL_DISCRETE_FIELD], default: UNIFORM) – A SymbolicConstant specifying the distribution used for defining the thickness of the elements. Possible values are UNIFORM, ANALYTICAL_FIELD, DISCRETE_FIELD, NODAL_ANALYTICAL_FIELD, and NODAL_DISCRETE_FIELD. The default value is UNIFORM.

  • preIntegrate (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the shell section properties are specified by the user prior to the analysis (ON) or integrated during the analysis (OFF). The default value is OFF.

  • poissonDefinition (Literal[DEFAULT, VALUE], default: DEFAULT) – A SymbolicConstant specifying whether to use the default value for the Poisson’s ratio. Possible values are:DEFAULT, specifying that the default value for the Poisson’s ratio is 0.5 in an Abaqus/Standard analysis and is obtained from the material definition in an Abaqus/Explicit analysis.VALUE, specifying that the Poisson’s ratio used in the analysis is the value provided in poisson.The default value is DEFAULT.

  • poisson (float, default: 0) – A Float specifying the Poisson’s ratio. Possible values are −1.0 ≤ poisson ≤ 0.5. This argument is valid only when poissonDefinition = VALUE. The default value is 0.5.

  • integrationRule (Literal[SIMPSON, GAUSS], default: SIMPSON) – A SymbolicConstant specifying the shell section integration rule. Possible values are SIMPSON and GAUSS. The default value is SIMPSON.

  • temperature (Literal[GRADIENT, POINTWISE], default: GRADIENT) – A SymbolicConstant specifying the mode used for temperature and field variable input across the section thickness. Possible values are GRADIENT and POINTWISE. The default value is GRADIENT.

  • idealization (Literal[NO_IDEALIZATION, SMEAR_ALL_LAYERS, MEMBRANE, BENDING], default: NO_IDEALIZATION) – A SymbolicConstant specifying the mechanical idealization used for the section calculations. This member is only applicable when preIntegrate is set to ON. Possible values are NO_IDEALIZATION, SMEAR_ALL_LAYERS, MEMBRANE, and BENDING. The default value is NO_IDEALIZATION.

  • nTemp (Optional[int], default: None) – None or an Int specifying the number of temperature points to be input. This argument is valid only when temperature = POINTWISE. The default value is None.

  • thicknessModulus (Optional[float], default: None) – None or a Float specifying the effective thickness modulus. This argument is relevant only for continuum shells and must be used in conjunction with the argument poisson. The default value is None.

  • useDensity (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not to use the value of density. The default value is OFF.

  • density (float, default: 0) – A Float specifying the value of density to apply to this section. The default value is 0.0.

  • thicknessField (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object used to define the thickness of the shell elements. The thicknessField argument applies only when thicknessType = ANALYTICAL_FIELD or thicknessType = DISCRETE_FIELD. The default value is an empty string.

  • nodalThicknessField (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object used to define the thickness of the shell elements at each node. The nodalThicknessField argument applies only when thicknessType = NODAL_ANALYTICAL_FIELD or thicknessType = NODAL_DISCRETE_FIELD. The default value is an empty string.

Returns:

A HomogeneousShellSection object.

Return type:

HomogeneousShellSection

HomogeneousSolidSection(name, material, thickness=1.0)[source]#

This method creates a HomogeneousSolidSection object.

Note

This function can be accessed by:

mdb.models[name].HomogeneousSolidSection
session.odbs[name].HomogeneousSolidSection

Note

Check HomogeneousSolidSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • material (str) – A String specifying the name of the material.

  • thickness (float, default: 1.0) –

    A Float specifying the thickness of the section. Possible values are None or greater than zero. The default value is 1.0.

    Changed in version 2018: The default value is now 1.0 instead of None.

Returns:

A HomogeneousSolidSection object.

Return type:

HomogeneousSolidSection

Raises:

  • InvalidNameError –

  • RangeError –

IProfile(name, l, h, b1, b2, t1, t2, t3)[source]#

This method creates an IProfile object.

Note

This function can be accessed by:

mdb.models[name].IProfile
session.odbs[name].IProfile

Note

Check IProfile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • l (float) – A Float specifying the l dimension (offset of 1-axis from the bottom flange surface) of the I profile. For more information, see [Beam cross-section library](https://help.3ds.com/2021/English/DSSIMULIA_Established/SIMACAEELMRefMap/simaelm-c-beamcrosssectlib.htm?ContextScope=all).

  • h (float) – A Float specifying the h dimension (height) of the I profile.

  • b1 (float) – A Float specifying the b1 dimension (bottom flange width) of the I profile.

  • b2 (float) – A Float specifying the b2 dimension (top flange width) of the I profile.

  • t1 (float) – A Float specifying the t1 dimension (bottom flange thickness) of the I profile.

  • t2 (float) – A Float specifying the t2 dimension (top flange thickness) of the I profile.

  • t3 (float) – A Float specifying the t3 dimension (web thickness) of the I profile.

Returns:

An IProfile object.

Return type:

IProfile

Raises:

RangeError –

ImplicitDynamicsStep(name, previous, description='', timePeriod=1, nlgeom=OFF, matrixStorage=abaqusConstants.SOLVER_DEFAULT, application=abaqusConstants.ANALYSIS_PRODUCT_DEFAULT, adiabatic=OFF, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=abaqusConstants.DEFAULT, hafTolMethod=abaqusConstants.VALUE, haftol=None, halfIncScaleFactor=None, nohaf=OFF, amplitude=abaqusConstants.STEP, alpha=abaqusConstants.DEFAULT, initialConditions=abaqusConstants.DEFAULT, extrapolation=abaqusConstants.ANALYSIS_PRODUCT_DEFAULT, noStop=OFF, maintainAttributes=False, solutionTechnique=abaqusConstants.FULL_NEWTON, reformKernel=8, convertSDI=abaqusConstants.PROPAGATED)[source]#

This method creates an ImplicitDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].ImplicitDynamicsStep

Note

Check ImplicitDynamicsStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • timePeriod (float, default: 1) – A Float specifying the total time period of the step. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is based on the previous step.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • application (SymbolicConstant, default: ANALYSIS_PRODUCT_DEFAULT) – A SymbolicConstant specifying the application type of the step. Possible values are ANALYSIS_PRODUCT_DEFAULT, TRANSIENT_FIDELITY, MODERATE_DISSIPATION, and QUASI_STATIC. The default value is ANALYSIS_PRODUCT_DEFAULT.

  • adiabatic (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an adiabatic stress analysis is to be performed. The default value is OFF.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.

  • maxInc (Union[SymbolicConstant, float], default: DEFAULT) – The SymbolicConstant DEFAULT or a Float specifying the maximum time increment allowed.

  • hafTolMethod (SymbolicConstant, default: VALUE) – A SymbolicConstant specifying the way of specifying half-increment residual tolerance with the automatic time incrementation scheme. Possible values are ANALYSIS_PRODUCT_DEFAULT, VALUE, and SCALE. The default value is VALUE.

  • haftol (Optional[float], default: None) – None or a Float specifying the half-increment residual tolerance to be used with the automatic time incrementation scheme. The default value is None.

  • halfIncScaleFactor (Optional[float], default: None) – None or a Float specifying the half-increment residual tolerance scale factor to be used with the automatic time incrementation scheme. The default value is None.

  • nohaf (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to suppress calculation of the half-increment residual. The default value is OFF.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.

  • alpha (Union[SymbolicConstant, float], default: DEFAULT) – The SymbolicConstant DEFAULT or a Float specifying the nondefault value of the numerical (artificial) damping control parameter, αα, in the implicit operator. Possible values are −.333 <α<<α< 0. The default value is DEFAULT.

  • initialConditions (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying whether accelerations should be calculated or recalculated at the beginning of the step. Possible values are DEFAULT, BYPASS, and ALLOW. The default value is DEFAULT.

  • extrapolation (SymbolicConstant, default: ANALYSIS_PRODUCT_DEFAULT) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, PARABOLIC, VELOCITY_PARABOLIC, and ANALYSIS_PRODUCT_DEFAULT. The default value is ANALYSIS_PRODUCT_DEFAULT.

  • noStop (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed have been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set noStop = OFF only in special cases when you have a thorough understanding of how to interpret the results.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the technique used to for solving nonlinear equations. Possible values are FULL_NEWTON and QUASI_NEWTON. The default value is FULL_NEWTON.

  • reformKernel (int, default: 8) – An Int specifying the number of quasi-Newton iterations allowed before the kernel matrix is reformed.. The default value is 8.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

Returns:

step – An ImplicitDynamicsStep object.

Return type:

ImplicitDynamicsStep

IncidentWave(name, createStepName, sourcePoint, standoffPoint, surface, interactionProperty, definition=abaqusConstants.PRESSURE, amplitude='', imaginaryAmplitude='', surfaceNormal=(), initialDepth=None, referenceMagnitude=None, detonationTime=None, magnitudeFactor=1)[source]#

This method creates an IncidentWave object.

Note

This function can be accessed by:

mdb.models[name].IncidentWave

Note

Check IncidentWave on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the IncidentWave object is created.

  • sourcePoint (Region) – A Region object specifying the incident wave source point.

  • standoffPoint (Region) – A Region object specifying the incident wave standoff point.This argument is not valid when definition = CONWEP.

  • surface (Region) – A Region object specifying the surface defining the incident wave interaction. In problems involving fluid/surface boundaries, both the fluid surface and the solid surface comprising the boundary must have an incident wave interaction specified.

  • interactionProperty (str) – A String specifying the IncidentWaveProperty object associated with this interaction.

  • definition (SymbolicConstant, default: PRESSURE) – A SymbolicConstant specifying the type of incident wave to be defined. The value must be PRESSURE for linear perturbation steps. An Explicit step is required when the value is set to CONWEP. Possible values are PRESSURE, ACCELERATION, UNDEX, and CONWEP. The default value is PRESSURE.

  • amplitude (str, default: '') – A String specifying the name of the Amplitude object that defines the fluid pressure time history at the standoff point, if definition = PRESSURE. If definition = ACCELERATION, then this string specifies the name of the Amplitude object that defines the fluid particle acceleration time history at the standoff point. This member can be specified only if definition = PRESSURE or ACCELERATION. The default value is an empty string.

  • imaginaryAmplitude (str, default: '') – A String specifying the name of the Amplitude object that defines the imaginary component of the fluid pressure time history at the standoff point. This member is applicable only for linear perturbation steps and if definition = PRESSURE. The default value is an empty string.

  • surfaceNormal (tuple, default: ()) – A sequence of three Floats specifying the X, Y, and Z components of the direction cosine of the fluid surface normal.This argument is valid only when definition = UNDEX.

  • initialDepth (Optional[float], default: None) – None or a Float specifying the initial depth of the UNDEX bubble. The default value is None.This argument is valid only when definition = UNDEX.

  • referenceMagnitude (Optional[float], default: None) – A Float specifying the reference magnitude.This argument is not valid when definition = CONWEP.

  • detonationTime (Optional[float], default: None) – A Float specifying the time of detonation, given in total time.This argument is valid only when definition = CONWEP.

  • magnitudeFactor (float, default: 1) – A Float specifying the magnitude scale factor. The default value is 1.0.This argument is valid only when definition = CONWEP.

Returns:

An IncidentWave object.

Return type:

IncidentWave

IncidentWaveProperty(name, definition=abaqusConstants.PLANAR, propagationModel=abaqusConstants.ACOUSTIC, soundSpeed=None, fluidDensity=None, specificHeatRatio=None, gravity=None, atmosphericPressure=None, dragCoefficient=None, dragExponent=2, waveEffects=ON, chargeDensity=None, chargeMass=None, constantK1=None, constantK2=None, constantA=None, constantB=None, constantKc=None, duration=None, maximumSteps=1500, relativeStepControl=None, absoluteStepControl=None, stepControlExponent=0, genDecayA=0, genDecayB=0, genDecayC=0, seedNumber=None, massTNT=None, massFactor=1, lengthFactor=1, timeFactor=1, pressureFactor=1)[source]#

This method creates an IncidentWaveProperty object.

Note

This function can be accessed by:

mdb.models[name].IncidentWaveProperty

Note

Check IncidentWaveProperty on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • definition (SymbolicConstant, default: PLANAR) – A SymbolicConstant specifying the type of wave to be defined. Possible values are PLANAR, SPHERICAL, DIFFUSE, AIR_BLAST, and SURFACE_BLAST. The default value is PLANAR.

  • propagationModel (SymbolicConstant, default: ACOUSTIC) – A SymbolicConstant specifying the spherical propagation model. Possible values are ACOUSTIC, UNDEX_CHARGE, and GENERALIZED_DECAY. The default value is ACOUSTIC.This argument is valid only when definition = SPHERICAL.

  • soundSpeed (Optional[float], default: None) – A Float specifying the speed of sound in the fluid.This argument is not valid when definition = AIR_BLAST or when definition = SURFACE_BLAST.

  • fluidDensity (Optional[float], default: None) – A Float specifying the fluid mass density.This argument is not valid when definition = AIR_BLAST or when definition = SURFACE_BLAST.

  • specificHeatRatio (Optional[float], default: None) – None or a Float specifying the ratio of specific heats for gas. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • gravity (Optional[float], default: None) – None or a Float specifying the acceleration due to gravity. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • atmosphericPressure (Optional[float], default: None) – None or a Float specifying the atmospheric pressure. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • dragCoefficient (Optional[float], default: None) – None or a Float specifying the fluid drag coefficient. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • dragExponent (float, default: 2) – A Float specifying the fluid drag exponent. The default value is 2.0.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • waveEffects (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether or not to include wave effects in the fluid and gas. The default value is ON.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • chargeDensity (Optional[float], default: None) – None or a Float specifying the density of the charge material. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • chargeMass (Optional[float], default: None) – None or a Float specifying the mass of the charge material. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • constantK1 (Optional[float], default: None) – None or a Float specifying the charge material constant K. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • constantK2 (Optional[float], default: None) – None or a Float specifying the charge material constant k. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • constantA (Optional[float], default: None) – None or a Float specifying the charge material constant A. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • constantB (Optional[float], default: None) – None or a Float specifying the charge material constant B. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • constantKc (Optional[float], default: None) – None or a Float specifying the charge material constant Kc. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • duration (Optional[float], default: None) – None or a Float specifying the time duration for the bubble simulation. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • maximumSteps (int, default: 1500) – An Int specifying the maximum number of time steps for the bubble simulation. The default value is 1500.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • relativeStepControl (Optional[float], default: None) – A Float specifying the relative step size control parameter. The default value is 1x10-11.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • absoluteStepControl (Optional[float], default: None) – A Float specifying the absolute step size control parameter. The default value is 1x10-11.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • stepControlExponent (float, default: 0) – A Float specifying the step size control exponent. The default value is 0.2.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • genDecayA (float, default: 0) – A Float specifying the constant A associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.

  • genDecayB (float, default: 0) – A Float specifying the constant B associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.

  • genDecayC (float, default: 0) – A Float specifying the constant C associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.

  • seedNumber (Optional[int], default: None) – An Int specifying the seed number (N) for the diffuse source calculation. N2 sources will be used in the simulation.This argument is valid only when definition = DIFFUSE.

  • massTNT (Optional[float], default: None) – A Float specifying the equivalent mass of TNT, in any preferred mass unit.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.

  • massFactor (float, default: 1) – A Float specifying the multiplication factor to convert from the preferred mass unit to kilograms. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.

  • lengthFactor (float, default: 1) – A Float specifying the multiplication factor to convert from the analysis length unit to meters. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.

  • timeFactor (float, default: 1) – A Float specifying the multiplication factor to convert from the analysis time unit to seconds. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.

  • pressureFactor (float, default: 1) – A Float specifying the multiplication factor to convert from the analysis pressure unit to pascals. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.

Returns:

An IncidentWaveProperty object.

Return type:

IncidentWaveProperty

InertiaRelief(name, createStepName, u1=OFF, u2=OFF, u3=OFF, ur1=OFF, ur2=OFF, ur3=OFF, referencePoint=(), localCoordinates=None)[source]#

This method creates an InertiaRelief object.

Note

This function can be accessed by:

mdb.models[name].InertiaRelief

Note

Check InertiaRelief on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • u1 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the 1-direction as a free direction.Note:Although u1, u2, u3, ur1, ur2, and ur3 are optional arguments, at least one of them must be specified. Further, any specified set of free directions cannot include only two rotational degrees of freedom.

  • u2 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the 2-direction as a free direction.

  • u3 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the 3-direction as a free direction.

  • ur1 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the rotation about the 1-direction as a free direction.

  • ur2 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the rotation about the 2-direction as a free direction.

  • ur3 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the rotation about the 3-direction as a free direction.

  • referencePoint (tuple, default: ()) – A sequence of Floats specifying the X, Y and Z-coordinates of a fixed rotation point or a point on the rotation axis or a point on the symmetry line, about which rotations are defined. Such a point must be specified only for certain combinations of free directions.

  • localCoordinates (Optional[int], default: None) – None or a DatumCsys object specifying the local coordinate system of the rigid body degrees of freedom for the inertia relief load. If localCoordinates = None, the free directions are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

Returns:

An InertiaRelief object.

Return type:

InertiaRelief

InitialState(name, instances, fileName, endStep=abaqusConstants.LAST_STEP, endIncrement=abaqusConstants.STEP_END, updateReferenceConfiguration=OFF)[source]#

This method creates an InitialState predefined field object.

Note

This function can be accessed by:

mdb.models[name].InitialState

Note

Check InitialState on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • instances (List[PartInstance]) – A PartInstanceArray object specifying the instances to which the predefined field is applied.

  • fileName (str) – A String specifying the name of the job that generated the initial state data.

  • endStep (SymbolicConstant, default: LAST_STEP) – The SymbolicConstant LAST_STEP or an Int specifying the step from which the initial state values are to be read or the SymbolicConstant LAST_STEP. The default value is LAST_STEP.

  • endIncrement (SymbolicConstant, default: STEP_END) – The SymbolicConstant STEP_END or an Int specifying the increment, interval or iteration of the step set in endStep or the SymbolicConstant STEP_END. The default value is STEP_END.

  • updateReferenceConfiguration (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to update the reference configuration based on the import data. The default value is OFF.

Returns:

An InitialState object.

Return type:

InitialState

Instance(name, objectToCopy)[source]#

This method copies a PartInstance object from the specified model and creates a new PartInstance object.

Note

This function can be accessed by:

mdb.models[name].Instance

Note

Check Instance on help.3ds.com/2021.

Parameters:
Returns:

A Model object.

Return type:

Model

IntegratedOutputSection(name, surface, refPoint=None, refPointAtCenter=OFF, refPointMotion=abaqusConstants.INDEPENDENT, localCsys=None, projectOrientation=OFF)[source]#

This method creates an IntegratedOutputSection object.

Note

This function can be accessed by:

mdb.models[name].IntegratedOutputSection

Note

Check IntegratedOutputSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • surface (Region) – A Region object specifying the surface over which the output is based.

  • refPoint (Optional[SymbolicConstant], default: None) – None or a Region object specifying the anchor point about which the integrated moment over the output region is computed or the SymbolicConstant None representing the global origin. The default value is None.

  • refPointAtCenter (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the refPoint be adjusted so that it coincides with the center of the output region in the initial configuration. This argument is valid only when you include the refPoint argument. The default value is OFF.

  • refPointMotion (Literal[AVERAGE_TRANSLATION, AVERAGE, INDEPENDENT], default: INDEPENDENT) – A SymbolicConstant specifying how to relate the motion of refPoint to the average motion of the output region. A value of INDEPENDENT will allow the refPoint to move independent of the output region. A value of AVERAGE_TRANSLATION will set the displacement of the refPoint equal to the average translation of the output region. A value of AVERAGE will set the displacement and rotation of the refPoint equal to the average translation of the output region. The default value is INDEPENDENT.This argument is valid only when you include the refPoint argument.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system used to express vector output. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

  • projectOrientation (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the coordinate system be projected onto the surface such that the 1-axis is normal to the surface. Projection onto a planar surface is such that the 1-axis is normal to the surface, and a projection onto a nonplanar surface is such that a least-squares fit surface will be used. The default value is OFF.

Returns:

An IntegratedOutputSection object.

Return type:

IntegratedOutputSection

InwardVolAccel(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET)[source]#

This method creates a InwardVolAccel object.

Note

This function can be accessed by:

mdb.models[name].InwardVolAccel

Note

Check InwardVolAccel on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the name of the first analysis step.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

An InwardVolAccel object.

Return type:

InwardVolAccel

KinematicHardening(name, region, numBackStress=1, equivPlasticStrain=(), backStress=(), sectPtNum=(), definition=abaqusConstants.KINEMATIC_HARDENING, rebarLayerNames=(), distributionType=abaqusConstants.MAGNITUDE)[source]#

This method creates a KinematicHardening object.

Note

This function can be accessed by:

mdb.models[name].KinematicHardening

Note

Check KinematicHardening on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • region (Region) – A Region object specifying the region to which the predefined field is applied.

  • numBackStress (int, default: 1) – An Int specifying the number of backstresses. The default value is 1.

  • equivPlasticStrain (tuple, default: ()) – A sequence of Floats specifying the initial equivalent Plastic strain.

  • backStress (tuple, default: ()) – A sequence of sequences of Floats specifying the initial backstress tensor for kinematic hardening models. The default value is an empty sequence.

  • sectPtNum (tuple, default: ()) – A sequence of Ints specifying section point numbers. This argument is valid only when definition = SECTION_PTS.

  • definition (SymbolicConstant, default: KINEMATIC_HARDENING) – A SymbolicConstant specifying different types of kinematic hardening. Possible values are KINEMATIC_HARDENING, CRUSHABLE_FOAM, REBAR, SECTION_PTS, and USER_DEFINED. The default value is KINEMATIC_HARDENING.

  • rebarLayerNames (tuple, default: ()) – A sequence of Strings specifying rebar layer names. This argument is valid only when definition = REBAR.

  • distributionType (SymbolicConstant, default: MAGNITUDE) – A SymbolicConstant specifying whether the load is uniform. Possible values are MAGNITUDE and ANALYTICAL_FIELD. The default value is MAGNITUDE.

Returns:

A KinematicHardening object.

Return type:

KinematicHardening

LProfile(name, a, b, t1, t2)[source]#

This method creates a LProfile object.

Note

This function can be accessed by:

mdb.models[name].LProfile
session.odbs[name].LProfile

Note

Check LProfile on help.3ds.com/2021.

Parameters:
Returns:

A LProfile object.

Return type:

LProfile

Raises:

RangeError –

LineLoad(name, createStepName, region, distributionType=abaqusConstants.UNIFORM, field='', comp1=None, comp2=None, comp3=None, amplitude=abaqusConstants.UNSET, system=abaqusConstants.GLOBAL)[source]#

This method creates a LineLoad object.

Note

This function can be accessed by:

mdb.models[name].LineLoad

Note

Check LineLoad on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • comp1 (Optional[float], default: None) – A Float or a Complex specifying the component of the load in the global or the beam local 1-direction.Note:Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero unless distributionType = USER_DEFINED.

  • comp2 (Optional[float], default: None) – A Float or a Complex specifying the component of the load in the global or the beam local 2-direction.

  • comp3 (Optional[float], default: None) – A Float or a Complex specifying the component of the load in the global 3-direction.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • system (SymbolicConstant, default: GLOBAL) – A SymbolicConstant specifying whether the load is applied in a global or the beam local frame of reference. Possible values are GLOBAL and LOCAL. The default value is GLOBAL.

Returns:

A LineLoad object.

Return type:

LineLoad

MPCSection(name, mpcType, userMode=abaqusConstants.DOF_MODE, userType=0)[source]#

This method creates a MPCSection object.

Note

This function can be accessed by:

mdb.models[name].MPCSection
session.odbs[name].MPCSection

Note

Check MPCSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • mpcType (Literal[BEAM_MPC, ELBOW_MPC, PIN_MPC, LINK_MPC, TIE_MPC, USER_DEFINED]) – A SymbolicConstant specifying the MPC type of the section. Possible values are BEAM_MPC, ELBOW_MPC, PIN_MPC, LINK_MPC, TIE_MPC, and USER_DEFINED.

  • userMode (Literal[DOF_MODE, NODE_MODE], default: DOF_MODE) – A SymbolicConstant specifying the mode of the MPC when it is user-defined. Possible values are DOF_MODE and NODE_MODE. The default value is DOF_MODE.The userMode argument applies only when mpcType = USER_DEFINED.

  • userType (int, default: 0) – An Int specifying to differentiate between different constraint types in a user-defined MPCSection. The default value is 0.The userType argument applies only when mpcType = USER_DEFINED.

Returns:

A MPCSection object.

Return type:

MPCSection

Raises:

RangeError –

MagneticVectorPotentialBC(name, createStepName, region, component1=None, component2=abaqusConstants.UNSET, component3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, localCsys=None)[source]#

This method creates a MagneticVectorPotentialBC object.

Note

This function can be accessed by:

mdb.models[name].MagneticVectorPotentialBC

Note

Check MagneticVectorPotentialBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • component1 (Optional[SymbolicConstant], default: None) – A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET

  • component2 (SymbolicConstant, default: UNSET) – A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • component3 (SymbolicConstant, default: UNSET) – A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

bc – A MagneticVectorPotentialBC object.

Return type:

MagneticVectorPotentialBC

MassDiffusionStep(name, previous, description='', response=abaqusConstants.TRANSIENT, timePeriod=1, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None, end=abaqusConstants.PERIOD, dcmax=0, amplitude=abaqusConstants.STEP, extrapolation=abaqusConstants.LINEAR, maintainAttributes=False, convertSDI=abaqusConstants.PROPAGATED)[source]#

This method creates a MassDiffusionStep object.

Note

This function can be accessed by:

mdb.models[name].MassDiffusionStep

Note

Check MassDiffusionStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • response (SymbolicConstant, default: TRANSIENT) – A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

  • timePeriod (float, default: 1) – A Float specifying the total time period. The default value is 1.0.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of 0.8 times the initial time increment or 10−5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • end (SymbolicConstant, default: PERIOD) – A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.

  • dcmax (float, default: 0) – A Float specifying the maximum normalized concentration change to be allowed in an increment. The default value is 0.0.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default is STEP. Possible values are STEP and RAMP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

Returns:

step – A MassDiffusionStep object.

Return type:

MassDiffusionStep

Material(name, description='', materialIdentifier='')[source]#

This method creates a Material object.

Note

This function can be accessed by:

mdb.models[name].Material

Note

Check Material on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the name of the new material.

  • description (str, default: '') – A String specifying user description of the material. The default value is an empty string.

  • materialIdentifier (str, default: '') – A String specifying material identifier for customer use. The default value is an empty string.

Returns:

A Material object.

Return type:

Material

MaterialAssignment(name, instanceList, useFields=OFF, assignmentList=(), fieldList=(), colorList=())[source]#

This method creates a MaterialAssignment predefined field object.

Note

This function can be accessed by:

mdb.models[name].MaterialAssignment

Note

Check MaterialAssignment on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • instanceList (List[PartInstance]) – A PartInstanceArray object specifying the part instances to which the predefined field is applied. All instances must be assigned the same Eulerian section.

  • useFields (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the volume fraction data will be uniform or defined by discrete fields. The default value is OFF.

  • assignmentList (tuple, default: ()) – A sequence of tuples specifying the uniform volume fractions to be assigned. This argument is valid only when useFields = FALSE. Each tuple contains two entries:A Region object.A tuple of Floats specifying the uniform volume fraction values. The length of the tuple must match the number of material instance names specified in the Eulerain section assigned to part instances specified by instanceList.

  • fieldList (tuple, default: ()) – A sequence of tuples specifying the discrete volume fractions to be assigned. This argument is valid only when useFields = TRUE. Each tuple contains two entries:A Region object.A tuple of Strings specifying Discrete Field names. The length of the tuple must match the number of material instance names specified in the Eulerain section assigned to part instances specified by instanceList.

  • colorList (tuple, default: ()) – A sequence of three Ints specifying colors used to display the material instance assignments. This is a sequence of R,G,B colors, where the values are represented by integers between 0 and 255. The default value is an empty sequence.

Returns:

A MaterialAssignment object.

Return type:

MaterialAssignment

MaterialFlowBC(name, createStepName, region, fieldName='', magnitude=0, distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET, fixed=OFF)[source]#

This method creates a MaterialFlowBC object.

Note

This function can be accessed by:

mdb.models[name].MaterialFlowBC

Note

Check MaterialFlowBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • magnitude (float, default: 0) – A Float specifying the material flow magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A MaterialFlowBC object.

Return type:

MaterialFlowBC

MembraneSection(name, material, thickness=1, thicknessType=abaqusConstants.UNIFORM, poissonDefinition=abaqusConstants.DEFAULT, poisson=0, thicknessField='')[source]#

This method creates a MembraneSection object.

Note

This function can be accessed by:

mdb.models[name].MembraneSection
session.odbs[name].MembraneSection

Note

Check MembraneSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • material (str) – A String specifying the name of the material.

  • thickness (float, default: 1) – A Float specifying the thickness for the section. Possible values are thickness >> 0.0. The default value is 1.0.

  • thicknessType (Literal[UNIFORM, ANALYTICAL_FIELD, DISCRETE_FIELD], default: UNIFORM) – A SymbolicConstant specifying the distribution used for defining the thickness of the elements. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

  • poissonDefinition (Literal[DEFAULT, VALUE], default: DEFAULT) – A SymbolicConstant specifying whether to use the default value for the Poisson’s ratio. Possible values are:DEFAULT, specifying that the default value for the Poisson’s ratio is 0.5 in an Abaqus/Standard analysis and is obtained from the material definition in an Abaqus/Explicit analysis.VALUE, specifying that the Poisson’s ratio used in the analysis is the value provided in poisson.The default value is DEFAULT.

  • poisson (float, default: 0) – A Float specifying the section Poisson’s ratio. Possible values are −1.0 ≤ poisson ≤ 0.5. This argument is valid only when poissonDefinition = VALUE. The default value is 0.5.

  • thicknessField (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object used to define the thickness of the shell elements. The thicknessField argument applies only when thicknessType = ANALYTICAL_FIELD or thicknessType = DISCRETE_FIELD. The default value is an empty string.

Returns:

A MembraneSection object.

Return type:

MembraneSection

Raises:

RangeError –

ModalDynamicsStep(name, previous, description='', continueAnalysis=OFF, timePeriod=1, incSize=1, directDamping=None, compositeDamping=None, rayleighDamping=None, amplitude=abaqusConstants.STEP, maintainAttributes=False, directDampingByFrequency=None, rayleighDampingByFrequency=None)[source]#

This method creates a ModalDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].ModalDynamicsStep

Note

Check ModalDynamicsStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • continueAnalysis (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step starts with zero initial conditions. The default value is OFF.

  • timePeriod (float, default: 1) – A Float specifying the total time period. The default value is 1.0.

  • incSize (float, default: 1) – A Float specifying the time increment to be used. The default value is 1.0.

  • directDamping (Optional[DirectDamping], default: None) – A DirectDamping object.

  • compositeDamping (Optional[CompositeDamping], default: None) – A CompositeDamping object.

  • rayleighDamping (Optional[RayleighDamping], default: None) – A RayleighDamping object.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • directDampingByFrequency (Optional[DirectDampingByFrequency], default: None) – A DirectDampingByFrequency object.

  • rayleighDampingByFrequency (Optional[RayleighDampingByFrequency], default: None) – A RayleighDampingByFrequency object.

Returns:

step – A ModalDynamicsStep object.

Return type:

ModalDynamicsStep

ModelChange(name, createStepName, isRestart=OFF, regionType=abaqusConstants.GEOMETRY, region=None, activeInStep=OFF, includeStrain=OFF)[source]#

This method creates a ModelChange object.

Note

This function can be accessed by:

mdb.models[name].ModelChange

Note

Check ModelChange on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the ModelChange object is created.

  • isRestart (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether this interaction is being used solely to indicate that model change may be required in a subsequent restart analysis (either for elements or contact pairs). The default value is OFF.

  • regionType (SymbolicConstant, default: GEOMETRY) – A SymbolicConstant specifying the region selection type. This argument is valid only when isRestart = False. Possible values are GEOMETRY, SKINS, STRINGERS, and ELEMENTS. The default value is GEOMETRY.

  • region (Optional[Region], default: None) – A Region object specifying the elements to be removed or reactivated. This argument is valid only when isRestart = False.

  • activeInStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether elements are being removed or reactivated. This argument is valid only when isRestart = False. The default value is OFF.

  • includeStrain (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether stress/displacement elements are reactivated with strain. This argument is valid only when isRestart = False and when activeInStep = True. The default value is OFF.

Returns:

A ModelChange object.

Return type:

ModelChange

ModelFromInputFile(name, inputFileName)[source]#

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]#

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]#

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModulatedAmplitude(name, initial, magnitude, start, frequency1, frequency2, timeSpan=abaqusConstants.STEP)[source]#

This method creates a ModulatedAmplitude object.

Note

This function can be accessed by:

mdb.models[name].ModulatedAmplitude
session.odbs[name].ModulatedAmplitude

Note

Check ModulatedAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • initial (float) – A Float specifying the constant A0A0.

  • magnitude (float) – A Float specifying the coefficient AA.

  • start (float) – A Float specifying the starting time t0t0. Possible values are non-negative numbers.

  • frequency1 (float) – A Float specifying the circular frequency 1 (ω1ω1). Possible values are positive numbers.

  • frequency2 (float) – A Float specifying the circular frequency 2 (ω2ω2). Possible values are positive numbers.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A ModulatedAmplitude object.

Return type:

ModulatedAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

Moment(name, createStepName, region, cm1=None, cm2=None, cm3=None, amplitude=abaqusConstants.UNSET, follower=OFF, localCsys=None, distributionType=abaqusConstants.UNIFORM, field='')[source]#

This method creates a Moment object.

Note

This function can be accessed by:

mdb.models[name].Moment

Note

Check Moment on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • cm1 (Optional[float], default: None) – A Float or a Complex specifying the load component in the 4-direction.Note:Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero.

  • cm2 (Optional[float], default: None) – A Float or a Complex specifying the load component in the 5- direction.

  • cm3 (Optional[float], default: None) – A Float or a Complex specifying the load component in the 6-direction.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • follower (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the direction of the force rotates with the rotation of the node. You should provide the follower argument only if it is valid for the specified step. The default value is OFF.

  • localCsys (Optional[int], default: None) – None or a DatumCsys object specifying the ID of the Datum coordinate system used as the local coordinate system of the load. If localCsys = None, the load is defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

Returns:

A Moment object.

Return type:

Moment

MultipointConstraint(name, surface, controlPoint, mpcType, csys=None, userType=0, userMode=abaqusConstants.DOF_MODE_MPC)[source]#

This method creates a MultipointConstraint object.

Note

This function can be accessed by:

mdb.models[name].MultipointConstraint

Note

Check MultipointConstraint on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • surface (Region) – A Region object specifying the surface on which the MultipointConstraint nodes are located.

  • controlPoint (Region) – A Region object specifying the constraint control point.

  • mpcType (SymbolicConstant) – A SymbolicConstant specifying the MPC type of the constraint. Possible values are BEAM_MPC, ELBOW_MPC, PIN_MPC, LINK_MPC, TIE_MPC, and USER_MPC.

  • csys (Optional[str], default: None) – None or a DatumCsys object specifying the initial orientation of the local coordinate system for the MultipointConstraint’s degrees of freedom. If localCsys = None, the MultipointConstraint is defined in the global coordinate system. The default value is None.

  • userType (int, default: 0) – An Int specifying to differentiate between different constraint types in a user-defined MultipointConstraint. The default value is 0.The userType argument applies only when mpcType = USER_MPC.

  • userMode (SymbolicConstant, default: DOF_MODE_MPC) – A SymbolicConstant specifying the mode of the constraint when it is user-defined. Possible values are DOF_MODE_MPC and NODE_MODE_MPC. The default value is DOF_MODE_MPC.The userMode argument applies only when mpcType = USER_MPC.

Returns:

A MultipointConstraint object.

Return type:

MultipointConstraint

OperatorFilter(name, cutoffFrequency, order=2, operation=abaqusConstants.NONE, halt=OFF, limit=None, invariant=abaqusConstants.NONE)[source]#

This method creates an OperatorFilter object.

Note

This function can be accessed by:

mdb.models[name].OperatorFilter
session.odbs[name].OperatorFilter

Note

Check OperatorFilter on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key. This name ANTIALIASING is reserved for filters generated internally by the program.

  • cutoffFrequency (float) – A Float specifying the attenuation point of the filter. Possible values are non-negative numbers. Order is not available for OperatorFilter.

  • order (int, default: 2) – An Int specifying the highest power of the filter transfer function. Possible values are non-negative numbers less than or equal to 20. Order is not available for OperatorFilter. The default value is 2.

  • operation (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the filter operator. Possible values are NONE, MIN, MAX, and ABS. The default value is NONE.

  • halt (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to stop the analysis if the specified limit is reached. The default value is OFF.

  • limit (Optional[float], default: None) – None or a Float specifying the threshold limit, an upper or lower bound for output values depending on the operation, or a bound for stopping the analysis when Halt is used. The default value is None.

  • invariant (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the invariant to which filtering is applied. Possible values are NONE, FIRST, and SECOND. The default value is NONE.

Returns:

An OperatorFilter object.

Return type:

OperatorFilter

Raises:

  • InvalidNameError –

  • RangeError –

PEGLoad(name, createStepName, region, distributionType=abaqusConstants.UNIFORM, field='', comp1=None, comp2=None, comp3=None, amplitude=abaqusConstants.UNSET)[source]#

This method creates a PEGLoad object.

Note

This function can be accessed by:

mdb.models[name].PEGLoad

Note

Check PEGLoad on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • comp1 (Optional[float], default: None) – A Float or a Complex specifying the load component at dof 1 of reference node 1.Note:Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero.

  • comp2 (Optional[float], default: None) – A Float or a Complex specifying the load component at dof 1 of reference node 2.

  • comp3 (Optional[float], default: None) – A Float or a Complex specifying the load component at dof 2 of reference node 2.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A PEGLoad object.

Return type:

PEGLoad

PEGSection(name, material, thickness=1, wedgeAngle1=0, wedgeAngle2=0)[source]#

This method creates a PEGSection object.

Note

This function can be accessed by:

mdb.models[name].PEGSection
session.odbs[name].PEGSection

Note

Check PEGSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • material (str) – A String specifying the name of the material.

  • thickness (float, default: 1) – A Float specifying the thickness of the section. Possible values are thickness >> 0.0. The default value is 1.0.

  • wedgeAngle1 (float, default: 0) – A Float specifying the value of the x component of the angle between the bounding planes, ΔϕxΔ⁢ϕx. The default value is 0.0.

  • wedgeAngle2 (float, default: 0) – A Float specifying the value of the y component of the angle between the bounding planes, ΔϕyΔ⁢ϕy. The default value is 0.0.

Returns:

A PEGSection object.

Return type:

PEGSection

Raises:

  • InvalidNameError –

  • RangeError –

Part(name, dimensionality, type, twist=OFF)[source]#

This method creates a Part object and places it in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part

Note

Check Part on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • dimensionality (Literal[THREE_D, TWO_D_PLANAR, AXISYMMETRIC]) – A SymbolicConstant specifying the dimensionality of the part. Possible values are THREE_D, TWO_D_PLANAR, and AXISYMMETRIC.

  • type (Literal[DEFORMABLE_BODY, EULERIAN, DISCRETE_RIGID_SURFACE, ANALYTIC_RIGID_SURFACE]) – A SymbolicConstant specifying the type of the part. Possible values are DEFORMABLE_BODY, EULERIAN, DISCRETE_RIGID_SURFACE, and ANALYTIC_RIGID_SURFACE.

  • twist (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include a twist DEGREE OF FREEDOM in the part (only available when dimensionality = AXISYMMETRIC and type = DEFORMABLE_BODY). The default value is OFF.

Returns:

A Part object.

Return type:

Part

PeriodicAmplitude(name, frequency, start, a_0, data, timeSpan=abaqusConstants.STEP)[source]#

This method creates a PeriodicAmplitude object.

Note

This function can be accessed by:

mdb.models[name].PeriodicAmplitude
session.odbs[name].PeriodicAmplitude

Note

Check PeriodicAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • frequency (float) – A Float specifying the circular frequency ωω. Possible values are positive numbers.

  • start (float) – A Float specifying the starting time t0t0. Possible values are positive numbers.

  • a_0 (float) – A Float specifying the constant A0A0.

  • data (tuple) – A sequence of pairs of Floats specifying AiAi and BiBi pairs.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A PeriodicAmplitude object.

Return type:

PeriodicAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

PinnedBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]#

This method creates a pinned TypeBC object.

Note

This function can be accessed by:

mdb.models[name].PinnedBC

Note

Check PinnedBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

PipePressure(name, createStepName, region, magnitude, diameter, hZero, hReference, field='', amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, side=abaqusConstants.INTERNAL)[source]#

This method creates a Pressure object.

Note

This function can be accessed by:

mdb.models[name].PipePressure

Note

Check PipePressure on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the pressure is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the pressure magnitude.Note:magnitude is optional if distributionType = USER_DEFINED.

  • diameter (float) – A Float specifying the effective inner or outer diameter.

  • hZero (float) – A Float specifying the height of the zero pressure level when distributionType = HYDROSTATIC.

  • hReference (float) – A Float specifying the height of the reference pressure level when distributionType = HYDROSTATIC.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM, HYDROSTATIC, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • side (SymbolicConstant, default: INTERNAL) – A SymbolicConstant specifying whether the pressure is applied internally or externally. Possible values are INTERNAL and EXTERNAL. The default value is INTERNAL.

Returns:

A PipePressure object.

Return type:

PipePressure

PipeProfile(name, r, t)[source]#

This method creates a PipeProfile object.

Note

This function can be accessed by:

mdb.models[name].PipeProfile
session.odbs[name].PipeProfile

Note

Check PipeProfile on help.3ds.com/2021.

Parameters:
Returns:

A PipeProfile object.

Return type:

PipeProfile

Raises:

RangeError –

PorePressureBC(name, createStepName, region, fieldName='', magnitude=0, distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET, fixed=OFF)[source]#

This method creates a PorePressureBC object.

Note

This function can be accessed by:

mdb.models[name].PorePressureBC

Note

Check PorePressureBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • magnitude (float, default: 0) – A Float specifying the pore pressure magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A PorePressureBC object.

Return type:

PorePressureBC

Pressure(name, createStepName, region, magnitude=0.0, hZero=0.0, hReference=0.0, field='', refPoint='', distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET)[source]#

This method creates a Pressure object.

Note

This function can be accessed by:

mdb.models[name].Pressure

Note

Check Pressure on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the pressure is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float, default: 0.0) – A Float or a Complex specifying the pressure magnitude.Note:magnitude is optional if distributionType = USER_DEFINED.

  • hZero (float, default: 0.0) – A Float specifying the height of the zero pressure level when distributionType = HYDROSTATIC.

  • hReference (float, default: 0.0) – A Float specifying the height of the reference pressure level when distributionType = HYDROSTATIC.

  • field (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object associated with this load. The field argument applies only when distributionType = FIELD or distributionType = DISCRETE_FIELD. The default value is an empty string.

  • refPoint (str, default: '') – A Region specifying the reference point from which the relative velocity is determined when distributionType = STAGNATION or VISCOUS.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the pressure is distributed spatially. Possible values are UNIFORM, USER_DEFINED, FIELD, HYDROSTATIC, STAGNATION, VISCOUS, TOTAL_FORCE, and DISCRETE_FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A Pressure object.

Return type:

Pressure

PressurePenetration(name, createStepName, contactInteraction, masterPoints, slavePoints, penetrationPressure, criticalPressure, amplitude=abaqusConstants.UNSET, penetrationTime=0)[source]#

This method creates a PressurePenetration object.

Note

This function can be accessed by:

mdb.models[name].PressurePenetration

Note

Check PressurePenetration on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the PressurePenetration object is created.

  • contactInteraction (str) – A String specifying the name of the Surface-to-surface contact (Standard) interaction.

  • masterPoints (List[Region]) – A RegionArray object specifying the points on the master surface that are exposed to the fluid.

  • slavePoints (List[Region]) – A RegionArray object specifying the points on the slave surface that are exposed to the fluid.

  • penetrationPressure (float) – A tuple of Floats specifying the fluid pressure magnitude. For steady state dynamic analyses, a tuple of Complexes specifying the fluid pressure magnitude.

  • criticalPressure (float) – A tuple of Floats specifying the critical contact pressure below which fluid penetration starts to occur.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • penetrationTime (float, default: 0) – A Float specifying the fraction of the current step time over which the fluid pressure on newly penetrated contact surface segments is ramped up to the current magnitude. The default value is 0.001.

Returns:

A PressurePenetration object.

Return type:

PressurePenetration

PsdDefinition(name, data, unitType=abaqusConstants.FORCE, referenceGravityAcceleration=1, referenecePower=0, user=OFF, timeSpan=abaqusConstants.STEP, amplitude='')[source]#

This method creates a PsdDefinition object.

Note

This function can be accessed by:

mdb.models[name].PsdDefinition
session.odbs[name].PsdDefinition

Note

Check PsdDefinition on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • data (tuple) – A sequence of sequences of Floats specifying the real part of the frequency function, the imaginary part of the frequency function, and the frequency or frequency band number values, depending on the value of unitType.

  • unitType (SymbolicConstant, default: FORCE) – A SymbolicConstant specifying the type of units for specifying the frequency function. FORCE implies power units. BASE implies gravity used to define base motion. DB implies decibel units. Possible values are FORCE, BASE, and DB. The default value is FORCE.

  • referenceGravityAcceleration (float, default: 1) – A Float specifying the reference gravity acceleration. This argument applies when unitType = BASE. The default value is 1.0.

  • referenecePower (float, default: 0) – A Float specifying the reference power value, in load units squared. This argument applies when unitType = DB. The default value is 0.0.

  • user (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the frequency function is defined in user subroutine UPSD. If specified, then data is not applicable, and the unitType value must not be DB. The default value is OFF.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

  • amplitude (str, default: '') – A String specifying the name of the amplitude that describes the dynamic event used to define the cross-spectral density frequency function. The default value is an empty string.

Returns:

A PsdDefinition object.

Return type:

PsdDefinition

Raises:

  • InvalidNameError –

  • RangeError –

RadiationToAmbient(name, createStepName, surface, emissivity, field='', distributionType=abaqusConstants.UNIFORM, radiationType=abaqusConstants.AMBIENT, ambientTemperature=0, ambientTemperatureAmp='')[source]#

This method creates a RadiationToAmbient object.

Note

This function can be accessed by:

mdb.models[name].RadiationToAmbient

Note

Check RadiationToAmbient on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the RadiationToAmbient object is created.

  • surface (Region) – A Region object specifying the surface to which the radiation interaction is applied.

  • emissivity (float) – A Float specifying the emissivity, ϵϵ.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when distributionType = ANALYTICAL_FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the radiation is distributed. This argument applies only when radiationType = AMBIENT. Possible values are UNIFORM and ANALYTICAL_FIELD. The default value is UNIFORM.

  • radiationType (SymbolicConstant, default: AMBIENT) – A SymbolicConstant specifying whether to use the default surface radiation behavior, or the cavity radiation approximation. Possible values are AMBIENT and CAVITY. The default value is AMBIENT.

  • ambientTemperature (float, default: 0) – A Float specifying the reference ambient temperature, θ0θ0. This argument applies only when radiationType = AMBIENT. The default value is 0.0.

  • ambientTemperatureAmp (str, default: '') – A String specifying the name of the Amplitude object that gives the variation of the ambient temperature with time.Note:Use None in an Abaqus/Standard analysis to specify that the reference ambient temperature is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference ambient temperature is applied throughout the step. This argument applies only when radiationType = AMBIENT.

Returns:

A RadiationToAmbient object.

Return type:

RadiationToAmbient

RandomResponseStep(name, previous, freq, description='', scale=abaqusConstants.LOG, directDamping=None, compositeDamping=None, rayleighDamping=None, structuralDamping=None, directDampingByFrequency=None, rayleighDampingByFrequency=None, structuralDampingByFrequency=None, maintainAttributes=False)[source]#

This method creates a RandomResponseStep object.

Note

This function can be accessed by:

mdb.models[name].RandomResponseStep

Note

Check RandomResponseStep on help.3ds.com/2021.

Parameters:
Returns:

step – A RandomResponseStep object.

Return type:

RandomResponseStep

RectangularProfile(name, a, b)[source]#

This method creates a RectangularProfile object.

Note

This function can be accessed by:

mdb.models[name].RectangularProfile
session.odbs[name].RectangularProfile

Note

Check RectangularProfile on help.3ds.com/2021.

Parameters:
Returns:

A RectangularProfile object.

Return type:

RectangularProfile

Raises:

RangeError –

RemeshingRule(name, stepName, variables, description='', region=abaqusConstants.MODEL, sizingMethod=abaqusConstants.DEFAULT, errorTarget=0, maxSolutionErrorTarget=0, minSolutionErrorTarget=0, meshBias=0, minElementSize=0, maxElementSize=0, outputFrequency=abaqusConstants.LAST_INCREMENT, specifyMinSize=OFF, specifyMaxSize=ON, coarseningFactor=abaqusConstants.DEFAULT_LIMIT, refinementFactor=abaqusConstants.DEFAULT_LIMIT, elementCountLimit=None)[source]#

This method creates a RemeshingRule object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

Check RemeshingRule on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the name of the object.

  • stepName (str) – A String specifying the name of the step in which resizing should occur for this rule.

  • variables (tuple) – A sequence of Strings specifying the output request variables that Abaqus will use as error indicators.

  • description (str, default: '') – A String specifying a descriptive string for this rule. The default value is an empty string.

  • region (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region in which Abaqus will remesh and generate output. The SymbolicConstant MODEL represents the entire applicable model. The default value is MODEL.

  • sizingMethod (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the method for calculating the new mesh sizes. The SymbolicConstant DEFAULT indicates that Abaqus will use the default calculation method for each individual variable. Possible values are DEFAULT, UNIFORM_ERROR, and MINIMUM_MAXIMUM. The default value is DEFAULT.

  • errorTarget (float, default: 0) – A Float specifying the target error percentage for each variable in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the errorTarget argument when sizingMethod = UNIFORM_ERROR. The default value is 0.0.

  • maxSolutionErrorTarget (float, default: 0) – A Float specifying the target error percentage at the location of the maximum solution value in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the maxSolutionErrorTarget argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

  • minSolutionErrorTarget (float, default: 0) – A Float specifying the target error percentage at the location of the minimum solution value in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the minSolutionErrorTarget argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

  • meshBias (int, default: 0) – An Int specifying an indication of how much Abaqus will bias the mesh toward the location of the maximum solution value in the region. The higher the value, the more the mesh will bias towards the location of the maximum solution value. You use the meshBias argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

  • minElementSize (float, default: 0) – A Float specifying the minimum size of any single element. The default value is 0.0.

  • maxElementSize (float, default: 0) – A Float specifying the maximum size of any single element. The default value is 0.0.

  • outputFrequency (SymbolicConstant, default: LAST_INCREMENT) – A SymbolicConstant specifying the frequency with which the error indicators are saved to the output database file (.odb). Possible values are LAST_INCREMENT and ALL_INCREMENTS. The default value is LAST_INCREMENT.

  • specifyMinSize (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying an indication of whether to use a user-supplied minimum element size or to calculate a characteristic minimum element size. The default value is OFF.

  • specifyMaxSize (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying an indication of whether to use a user-supplied maximum element size or to calculate a characteristic maximum element size. The default value is ON.

  • coarseningFactor (SymbolicConstant, default: DEFAULT_LIMIT) – A SymbolicConstant or an Int specifying an indication of the upper limit on the element growth from one remeshing iteration to the next. Possible values are DEFAULT_LIMIT and NOT_ALLOWED. The default value is DEFAULT_LIMIT.

  • refinementFactor (SymbolicConstant, default: DEFAULT_LIMIT) – A SymbolicConstant or an Int specifying an indication of the upper limit on element shrinkage from one remeshing iteration to the next. Possible values are DEFAULT_LIMIT and NOT_ALLOWED. The default value is DEFAULT_LIMIT.

  • elementCountLimit (Optional[int], default: None) – None or an Int specifying an approximate limit on the number of elements that will be created during remeshing. Use None to indicate there is not upper limit. The default value is None.

Returns:

A RemeshingRule object

Return type:

RemeshingRule

ResponseSpectrumStep(name, previous, components, description='', comp=abaqusConstants.SINGLE_DIRECTION, sum=abaqusConstants.ABS, directDamping=None, compositeDamping=None, rayleighDamping=None, directDampingByFrequency=None, rayleighDampingByFrequency=None, maintainAttributes=False)[source]#

This method creates a ResponseSpectrumStep object.

Note

This function can be accessed by:

mdb.models[name].ResponseSpectrumStep

Note

Check ResponseSpectrumStep on help.3ds.com/2021.

Parameters:
Returns:

step – A ResponseSpectrumStep object.

Return type:

ResponseSpectrumStep

RetainedNodalDofsBC(name, createStepName, region, u1=OFF, u2=OFF, u3=OFF, ur1=OFF, ur2=OFF, ur3=OFF)[source]#

This method creates a RetainedNodalDofsBC object.

Note

This function can be accessed by:

mdb.models[name].RetainedNodalDofsBC

Note

Check RetainedNodalDofsBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • u1 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to retain the degree of freedom in the 1-direction. The default value is OFF indicating that the degree of freedom is not retained.

  • u2 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to retain the degree of freedom in the 2-direction. The default value is OFF indicating that the degree of freedom is not retained.

  • u3 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to retain the degree of freedom in the 3-direction. The default value is OFF indicating that the degree of freedom is not retained.

  • ur1 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to retain the rotational degree of freedom about the 1-direction. The default value is OFF indicating that the degree of freedom is not retained.

  • ur2 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to retain the rotational degree of freedom about the 2-direction. The default value is OFF indicating that the degree of freedom is not retained.

  • ur3 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to retain the rotational degree of freedom about the 3-direction. The default value is OFF indicating that the degree of freedom is not retained.

Returns:

bc – A RetainedNodalDofsBC object.

Return type:

RetainedNodalDofsBC

RigidBody(name, refPointRegion, bodyRegion=None, tieRegion=None, pinRegion=None, surfaceRegion=None, refPointAtCOM=OFF, isothermal=OFF)[source]#

This method creates a RigidBody object.

Note

This function can be accessed by:

mdb.models[name].RigidBody

Note

Check RigidBody on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • refPointRegion (Region) – A Region object specifying the reference point.

  • bodyRegion (Optional[str], default: None) – None or a Region object specifying the elements constrained to the movement of the reference point. The default value is None.

  • tieRegion (Optional[str], default: None) – None or a Region object specifying the nodes tied to the movement of the reference point. The default value is None.

  • pinRegion (Optional[str], default: None) – None or a Region object specifying the nodes pinned to the movement of the reference point. The default value is None.

  • surfaceRegion (Optional[str], default: None) – None or a Region object specifying the analytic surface constrained to the movement of the reference point. The default value is None.

  • refPointAtCOM (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the analysis product should recompute the reference point position to be at the center of mass. The default value is OFF.

  • isothermal (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the temperature degree of freedom should be constrained. The default value is OFF.

Returns:

A RigidBody object.

Return type:

RigidBody

RotationalBodyForce(name, createStepName, region, magnitude, point1, point2, distributionType=abaqusConstants.UNIFORM, field='', centrifugal=OFF, rotaryAcceleration=OFF, amplitude=abaqusConstants.UNSET)[source]#

This method creates a RotationalBodyForce object.

Note

This function can be accessed by:

mdb.models[name].RotationalBodyForce

Note

Check RotationalBodyForce on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • point1 (tuple) – A sequence of Floats specifying the first point on the axis of rotation for the load.

  • point2 (tuple) – A sequence of Floats specifying the second point on the axis of rotation for the load.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • centrifugal (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not the effect of the load is centrifugal. The default value is OFF.Note:At least one of centrifugal or rotaryAcceleration must be specified and only one must have the value ON.

  • rotaryAcceleration (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not the effect of the load is rotary acceleration. The default value is OFF.Note:At least one of centrifugal or rotaryAcceleration must be specified and only one must have the value ON.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A RotationalBodyForce object.

Return type:

RotationalBodyForce

SecondaryBaseBC(name, createStepName, regions, dofs)[source]#

This method creates a SecondaryBaseBC object.

Note

This function can be accessed by:

mdb.models[name].SecondaryBaseBC

Note

Check SecondaryBaseBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • regions (List[Region]) – A RegionArray object specifying the region to which the boundary condition is applied. Note that the usual region is ignored. The default value is MODEL.

  • dofs (tuple) – A sequence of sequences of Ints specifying the constrained degrees-of-freedom.

Returns:

bc – A SecondaryBaseBC object.

Return type:

SecondaryBaseBC

SelfContactExp(name, createStepName, surface, interactionProperty, mechanicalConstraint=abaqusConstants.KINEMATIC, contactControls='')[source]#

This method creates a SelfContactExp object.

Note

This function can be accessed by:

mdb.models[name].SelfContactExp

Note

Check SelfContactExp on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the SelfContactExp object is created.

  • surface (Region) – A Region object specifying the surface where self-contact is defined.

  • interactionProperty (str) – A String specifying the name of the ContactProperty object associated with this interaction.

  • mechanicalConstraint (SymbolicConstant, default: KINEMATIC) – A SymbolicConstant specifying the mechanical constraint formulation. Possible values are KINEMATIC and PENALTY. The default value is KINEMATIC.

  • contactControls (str, default: '') – A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.

Returns:

A SelfContactExp object.

Return type:

SelfContactExp

SelfContactStd(name, createStepName, surface, interactionProperty, enforcement=abaqusConstants.SURFACE_TO_SURFACE, thickness=ON, smooth=0, contactControls='')[source]#

This method creates a SelfContactStd object.

Note

This function can be accessed by:

mdb.models[name].SelfContactStd

Note

Check SelfContactStd on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the SelfContactStd object is created.

  • surface (Region) – A Region object specifying the surface where self-contact is defined.

  • interactionProperty (str) – A String specifying the name of the ContactProperty object associated with this interaction.

  • enforcement (SymbolicConstant, default: SURFACE_TO_SURFACE) – A SymbolicConstant specifying the discretization method. Possible values are NODE_TO_SURFACE and SURFACE_TO_SURFACE. The default value is SURFACE_TO_SURFACE.

  • thickness (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether shell/membrane element thickness is considered. The default value is ON.This argument in valid only when enforcement = SURFACE_TO_SURFACE.

  • smooth (float, default: 0) – A Float specifying the degree of smoothing used for deformable or rigid master surfaces involved when enforcement = NODE_TO_SURFACE. The value given must lie between 0.0 and 0.5. The default value is 0.2.

  • contactControls (str, default: '') – A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.

Returns:

A SelfContactStd object.

Return type:

SelfContactStd

ShapeTask(name, abaqusSensitivities=True, absoluteStepSizeControl=abaqusConstants.MINIMUM, activateDurability=ON, additionalDurabilityFiles='', constrainedLaplacianConvergenceLevel=abaqusConstants.NORMAL, curvatureSmoothingEdgeLength=5, durabilityInputfile='', durabilitySolver=abaqusConstants.FE_SAFE, equalityConstraintTolerance=None, featureRecognitionAngle=30, filterExponent=1, filterMaxRadius=None, filterRadiusReduction=None, firstCycleDeletedVolumeTechnique=OFF, freezeBoundaryConditionRegions=OFF, frozenBoundaryConditionRegion=abaqusConstants.MODEL, geometricRestrictionEvaluationFrequency=abaqusConstants.LOW, growthScaleFactor=1, haltUponViolation=OFF, layerReferenceRegion=None, meshSmoothingRegionMethod=abaqusConstants.TASK_REGION_LAYERS, meshSmoothingStrategy=abaqusConstants.CONSTRAINED_LAPLACIAN, midsideInterpolation=abaqusConstants.POSITIONS, numFreeNodeLayers=0, numSmoothedElementLayers=None, presumeFeasibleBCRegionAtStart=ON, quadMaxAngle=160, quadMinAngle=20, quadSkew=30, quadTaper=0, region=abaqusConstants.MODEL, reportPoorQualityElements=OFF, reportQualityViolation=OFF, shrinkScaleFactor=1, smoothingRegion=None, targetMeshQuality=abaqusConstants.LOW, tetAspectRatio=100, tetMaxAspect=8, tetMinAspect=0, tetSkew=100, triMaxAngle=140, triMinAngle=20, updateShapeBasisVectors=abaqusConstants.EVERY_CYCLE)[source]#

This method creates a ShapeTask object.

Note

This function can be accessed by:

mdb.models[name].ShapeTask

Note

Check ShapeTask on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the optimization task repository key.

  • abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –

    A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

    New in version 2019: The abaqusSensitivities argument was added.

  • absoluteStepSizeControl (SymbolicConstant, default: MINIMUM) – A SymbolicConstant specifying whether to control the permitted absolute step size by the average optimization displacement or minimum optimization displacement. Possible values are MINIMUM and AVERAGE. The default value is MINIMUM.

  • activateDurability (Union[AbaqusBoolean, bool], default: ON) – A boolean specifying whether or not the durability approach of optimization is turned on. The default value is ON.

  • additionalDurabilityFiles (str, default: '') – A String specifying the path of additional files pertaining to durability optimization. Only valid if the activateDurability argument is ON.

  • constrainedLaplacianConvergenceLevel (SymbolicConstant, default: NORMAL) – A SymbolicConstant specifying the constrained Laplacian convergence level. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

  • curvatureSmoothingEdgeLength (float, default: 5) – A Float specifying the edge length for the movement vector. The default value is 5.0.

  • durabilityInputfile (str, default: '') – A string specifying the path of the input file. Only valid if the activateDurability argument is ON and is a required argument in that case.

  • durabilitySolver (str, default: FE_SAFE) – A String specifying the type of solver for durability optimization. Possible values are: FE_SAFE, FEMFAT, FLANS, MSC_FATIGUE, FE_FATIGUE, DESIGN_LIFE, CUSTOM, FEMSITE. The default value is FE_SAFE. Only valid if the activateDurability argument is ON.

  • equalityConstraintTolerance (Optional[float], default: None) – A Float specifying the equality constraint tolerance. The default value is 10-3.

  • featureRecognitionAngle (float, default: 30) – A Float specifying the mesh smoothing feature recognition angle for edges and corners. The default value is 30.0.

  • filterExponent (float, default: 1) – A Float specifying the weight depending on the radius, used when filterMaxRadius is specified. The default value is 1.0.

  • filterMaxRadius (Optional[float], default: None) – None or a Float specifying the maximum influence radius for equivalent stress. The default value is None.

  • filterRadiusReduction (Optional[float], default: None) – None or a Float specifying the reduction of the radius depending on surface bending, used when filterMaxRadius is specified. The default value is None.

  • firstCycleDeletedVolumeTechnique (SymbolicConstant, default: OFF) – A SymbolicConstant specifying the method of specifying volume that can be removed immediately in the first design cycle. Possible values are OFF, PERCENTAGE, and ABSOLUTE. The default value is OFF.

  • freezeBoundaryConditionRegions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude nodes with boundary conditions from the optimization. The default value is OFF.

  • frozenBoundaryConditionRegion (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region in which to freeze boundary condition regions, or the SymbolicConstant MODEL, used with freezeBoundaryConditionRegions. The default value is MODEL.

  • geometricRestrictionEvaluationFrequency (SymbolicConstant, default: LOW) – A SymbolicConstant specifying the frequency of evaluating geometric restrictions during mesh smoothing. Possible values are LOW, MEDIUM, and HIGH. The default value is LOW.

  • growthScaleFactor (float, default: 1) – A Float specifying the scale factor to apply to optimization displacements for nodes with growth. The default value is 1.0.

  • haltUponViolation (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to halt the optimization if quality criteria are not satisified. The default value is OFF.

  • layerReferenceRegion (Optional[str], default: None) – None or a Region object specifying the region specifying the first node layer for mesh smoothing, used when meshSmoothingRegionMethod is TASK_REGION_LAYERS. The default value is None.

  • meshSmoothingRegionMethod (SymbolicConstant, default: TASK_REGION_LAYERS) – A SymbolicConstant specifying the method used to determine the mesh smoothing region. The REGION value uses the smoothingRegion. The NUMBER_OF_LAYERS value uses the layerReferenceRegion. The TASK_REGION_LAYERS value will smooth six layers using the task region. Possible values are TASK_REGION_LAYERS, REGION, and NUMBER_OF_LAYERS. The default value is TASK_REGION_LAYERS.

  • meshSmoothingStrategy (SymbolicConstant, default: CONSTRAINED_LAPLACIAN) – A SymbolicConstant specifying the method smoothing strategy. Possible values are CONSTRAINED_LAPLACIAN and LOCAL_GRADIENT. The default value is CONSTRAINED_LAPLACIAN.

  • midsideInterpolation (SymbolicConstant, default: POSITIONS) – A SymbolicConstant specifying the approach used when treating midside node positions during optimization. POSITIONS indicates midside node positions are interpolated linearly by position. OPTIMIZATION_DISPLACEMENT indicates they are interpolated by optimization displacement of corner nodes. Possible values are POSITIONS and OPTIMIZATION_DISPLACEMENT. The default value is POSITIONS.

  • numFreeNodeLayers (SymbolicConstant, default: 0) – The SymbolicConstant FIX_NONE or an Int specifying the number of node layers adjoining the task region to remain free during mesh smoothing. A value of 0 indicates that no layers are free and all layers are fixed. The default value is 0.

  • numSmoothedElementLayers (Optional[int], default: None) – None or an Int specifying the number of layers for mesh smoothing when meshSmoothingRegionMethod is NUMBER_OF_LAYERS. The default value is None.

  • presumeFeasibleBCRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore automatically frozen boundary condition regions in the first design cycle. This is used with freezeBoundaryConditionRegions. The default value is ON.

  • quadMaxAngle (float, default: 160) – A Float specifying the maximum angle for quad elements during mesh smoothing. The default value is 160.0.

  • quadMinAngle (float, default: 20) – A Float specifying the minimum angle for quad elements during mesh smoothing. The default value is 20.0.

  • quadSkew (float, default: 30) – A Float specifying the skew angle for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 30.0.

  • quadTaper (float, default: 0) – A Float specifying the taper for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 0.5.

  • region (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.

  • reportPoorQualityElements (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to report poor quality elements during mesh smoothing. The default value is OFF.

  • reportQualityViolation (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to report a quality criteria violation during mesh smoothing. The default value is OFF.

  • shrinkScaleFactor (float, default: 1) – A Float specifying the scale factor to apply to optimization displacements for nodes with shrinkage. The default value is 1.0.

  • smoothingRegion (Optional[str], default: None) – None or a Region object specifying the mesh smoothing region, used when meshSmoothingRegionMethod is REGION. The default value is None.

  • targetMeshQuality (SymbolicConstant, default: LOW) – A SymbolicConstant specifying the target mesh quality for mesh smoothing. Possible values are NONE, LOW, MEDIUM, and HIGH. The default value is LOW.

  • tetAspectRatio (float, default: 100) – A Float specifying the tet element aspect ratio during mesh smoothing. The default value is 100.0.

  • tetMaxAspect (float, default: 8) – A Float specifying the maximum tet element aspect ratio during mesh smoothing. The default value is 8.0.

  • tetMinAspect (float, default: 0) – A Float specifying the minimum tet element aspect ratio during mesh smoothing. The default value is 0.222.

  • tetSkew (float, default: 100) – A Float specifying the tet element skew value during mesh smoothing. The default value is 100.0.

  • triMaxAngle (float, default: 140) – A Float specifying the tri element maximum angle during mesh smoothing. The default value is 140.0.

  • triMinAngle (float, default: 20) – A Float specifying the tri element maximum angle during mesh smoothing. The default value is 20.0.

  • updateShapeBasisVectors (SymbolicConstant, default: EVERY_CYCLE) – A SymbolicConstant specifying whether to update shape basis vectors in the first design cycle or every design cycle. Possible values are EVERY_CYCLE and FIRST_CYCLE. The default value is EVERY_CYCLE.

Returns:

A ShapeTask object.

Return type:

ShapeTask

ShellEdgeLoad(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET, angle=0, axis=abaqusConstants.AXIS_1, localCsys=abaqusConstants.GENERAL, userCsys=abaqusConstants.GENERAL, directionVector=(), follower=ON, resultant=OFF, traction=abaqusConstants.NORMAL)[source]#

This method creates a ShellEdgeLoad object.

Note

This function can be accessed by:

mdb.models[name].ShellEdgeLoad

Note

Check ShellEdgeLoad on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float or Complex specifying the load magnitude. magnitude is optional if distributionType = USER_DEFINED

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the shell edge load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • angle (float, default: 0) – A Float specifying an additional rotation of directionVector about an axis. The default value is 0.This parameter is available only if traction is GENERAL.

  • axis (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis about which to apply an additional rotation of directionVector. Possible values are AXIS_1, AXIS_2, AXIS_3. The default value is AXIS_1.This parameter is available only if traction is GENERAL.

  • localCsys (int, default: GENERAL) – A DatumCsys object specifying the local coordinate system of the load’s degrees of freedom. The default value is None, indicating that the degrees of freedom are defined in the global coordinate system or by the userCsys parameter if defined. This parameter is available only if traction is GENERAL. When this member is queried, it returns an Int.

  • userCsys (str, default: GENERAL) – A String specifying a CSYS defined by a user-subroutine. The default value is None, indicating that the degrees of freedom are defined in the global coordinate system or by the localCsys parameter if defined. This parameter is available only if traction is GENERAL.

  • directionVector (tuple, default: ()) – A tuple of two points specifying the direction of the load. Each point is specified as a point region or a tuple of coordinates. If traction is SHEAR, then directionVector will be projected onto the region surface. This parameter is available only if traction is GENERAL.

  • follower (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the direction of the force changes with rotation. The default value is ON. This parameter may be modified only if traction is GENERAL. You should provide the follower argument only if it is valid for the specified step.

  • resultant (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to maintain a constant resultant force by defining traction per unit undeformed area. If resultant is OFF, traction is defined per unit deformed area. The default value is OFF. You should provide the resultant argument only if it is valid for the specified step.

  • traction (SymbolicConstant, default: NORMAL) – A SymbolicConstant specifying how to apply surface traction. Possible values are NORMAL, TRANSVERSE, SHEAR, MOMENT and GENERAL. The default value is NORMAL.

Returns:

A ShellEdgeLoad object.

Return type:

ShellEdgeLoad

ShellSolidCoupling(name, shellEdge, solidFace, positionToleranceMethod=abaqusConstants.COMPUTED, positionTolerance=0, influenceDistanceMethod=abaqusConstants.DEFAULT, influenceDistance=0)[source]#

This method creates a ShellSolidCoupling object.

Note

This function can be accessed by:

mdb.models[name].ShellSolidCoupling

Note

Check ShellSolidCoupling on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • shellEdge (Region) – A Region object specifying the name of the shell edge surface.

  • solidFace (Region) – A Region object specifying the name of the solid surface.

  • positionToleranceMethod (SymbolicConstant, default: COMPUTED) – A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED and SPECIFIED. The default value is COMPUTED.

  • positionTolerance (float, default: 0) – A Float specifying the position tolerance. The default value is 0.0.The positionTolerance argument applies only when positionToleranceMethod = SPECIFIED.Note:Abaqus will not constrain nodes on the solid face region outside the position tolerance.

  • influenceDistanceMethod (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the method used to determine the influence distance. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.

  • influenceDistance (float, default: 0) – A Float specifying the influence distance. The influenceDistance argument applies only when influenceDistanceMethod = SPECIFIED. The default value is 0.0.

Returns:

A ShellSolidCoupling object.

Return type:

ShellSolidCoupling

SizingTask(name, abaqusSensitivities=True, elementThicknessDeltaStopCriteria=0, freezeBoundaryConditionRegions=OFF, freezeLoadRegions=ON, modeTrackingRegion=abaqusConstants.MODEL, numFulfilledStopCriteria=2, numTrackedModes=5, objectiveFunctionDeltaStopCriteria=0, stopCriteriaDesignCycle=4, thicknessMoveLimit=0, thicknessUpdateStrategy=abaqusConstants.NORMAL)[source]#

This method creates a SizingTask object.

Note

This function can be accessed by:

mdb.models[name].SizingTask

Note

Check SizingTask on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the optimization task repository key.

  • abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –

    A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

    New in version 2019: The abaqusSensitivities argument was added.

  • elementThicknessDeltaStopCriteria (float, default: 0) – A Float specifying the stop criteria based on the change in element thickness. The default value is 0.5 × 10-2.

  • freezeBoundaryConditionRegions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

  • freezeLoadRegions (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.

  • modeTrackingRegion (str, default: MODEL) – The SymbolicConstatnt MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

  • numFulfilledStopCriteria (int, default: 2) – An Int specifying the number of stop criteria. The default value is 2.

  • numTrackedModes (int, default: 5) – An Int specifying the number of modes included in mode tracking. The default value is 5.

  • objectiveFunctionDeltaStopCriteria (float, default: 0) – A Float specifying the stop criteria based on the change in objective function. The default value is 0.001.

  • stopCriteriaDesignCycle (int, default: 4) – An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.

  • thicknessMoveLimit (float, default: 0) – A Float specifying the maximum change in thickness per design cycle. The default value is 0.25.

  • thicknessUpdateStrategy (SymbolicConstant, default: NORMAL) – A SymbolicConstant specifying the strategy for how the thickness is updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

Returns:

A SizingTask object.

Return type:

SizingTask

SmoothStepAmplitude(name, data, timeSpan=abaqusConstants.STEP)[source]#

This method creates a SmoothStepAmplitude object.

Note

This function can be accessed by:

mdb.models[name].SmoothStepAmplitude
session.odbs[name].SmoothStepAmplitude

Note

Check SmoothStepAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • data (tuple) – A sequence of pairs of Floats specifying time/frequency and amplitude pairs. Possible values for time/frequency are positive numbers.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A SmoothStepAmplitude object.

Return type:

SmoothStepAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

SoilsStep(name, previous, description='', response=abaqusConstants.TRANSIENT, timePeriod=1, nlgeom=OFF, stabilizationMethod=abaqusConstants.NONE, stabilizationMagnitude=None, creep=ON, timeIncrementationMethod=abaqusConstants.AUTOMATIC, initialInc=None, minInc=None, maxInc=None, maxNumInc=100, end=abaqusConstants.PERIOD, utol=None, cetol=0, amplitude=abaqusConstants.STEP, extrapolation=abaqusConstants.LINEAR, matrixSolver=abaqusConstants.DIRECT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False, solutionTechnique=abaqusConstants.FULL_NEWTON, reformKernel=8, convertSDI=abaqusConstants.PROPAGATED, adaptiveDampingRatio=0, continueDampingFactors=OFF)[source]#

This method creates a SoilsStep object.

Note

This function can be accessed by:

mdb.models[name].SoilsStep

Note

Check SoilsStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • response (SymbolicConstant, default: TRANSIENT) – A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

  • timePeriod (float, default: 1) – A Float specifying the total time period. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.

  • stabilizationMethod (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

  • stabilizationMagnitude (Optional[float], default: None) – A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10-4.

  • creep (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether a creep response occurs during this step. The default value is ON.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • end (SymbolicConstant, default: PERIOD) – A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.

  • utol (Optional[float], default: None) – None or a Float specifying the maximum pore pressure change permitted in any increment (in pressure units) in a transient consolidation analysis. The default value is None.

  • cetol (float, default: 0) – A Float specifying the maximum allowable difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • matrixSolver (SymbolicConstant, default: DIRECT) – A SymbolicConstant specifying the type of solver. Possible values are DIRECT and ITERATIVE. The default value is DIRECT.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the technique used to for solving nonlinear equations. Possible values are FULL_NEWTON and QUASI_NEWTON. The default value is FULL_NEWTON.

  • reformKernel (int, default: 8) – An Int specifying the number of quasi-Newton iterations allowed before the kernel matrix is reformed.. The default value is 8.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

  • adaptiveDampingRatio (float, default: 0) – A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

  • continueDampingFactors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step – A SoilsStep object.

Return type:

SoilsStep

SolutionDependentAmplitude(name, initial=1, minimum=0, maximum=1000, timeSpan=abaqusConstants.STEP)[source]#

This method creates a SolutionDependentAmplitude object.

Note

This function can be accessed by:

mdb.models[name].SolutionDependentAmplitude
session.odbs[name].SolutionDependentAmplitude

Note

Check SolutionDependentAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • initial (float, default: 1) – A Float specifying the initial amplitude value. Possible values are those between minimum and maximum. The default value is 1.0.

  • minimum (float, default: 0) – A Float specifying the minimum amplitude value. Possible values are those smaller than maximum and initial. The default value is 0.1.

  • maximum (float, default: 1000) – A Float specifying the maximum amplitude value. Possible values are those larger than minimum and initial. The default value is 1000.0.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A SolutionDependentAmplitude object.

Return type:

SolutionDependentAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

SpectrumAmplitude(name, method, data, specificationUnits=abaqusConstants.ACCELERATION, eventUnits=abaqusConstants.EVENT_ACCELERATION, solution=abaqusConstants.ABSOLUTE_VALUE, timeIncrement=0, gravity=1, criticalDamping=OFF, timeSpan=abaqusConstants.STEP, amplitude='')[source]#

This method creates a SpectrumAmplitude object.

Note

This function can be accessed by:

mdb.models[name].SpectrumAmplitude
session.odbs[name].SpectrumAmplitude

Note

Check SpectrumAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • method (SymbolicConstant) – A SymbolicConstant specifying the method for specifying the spectrum. Possible values are DEFINE and CALCULATE.

  • data (tuple) – A sequence of sequences of Floats specifying the magnitude, frequency, and damping values.

  • specificationUnits (SymbolicConstant, default: ACCELERATION) – A SymbolicConstant specifying the units used for specifying the spectrum. Possible values are DISPLACEMENT, VELOCITY, ACCELERATION, and GRAVITY. The default value is ACCELERATION.

  • eventUnits (SymbolicConstant, default: EVENT_ACCELERATION) – A SymbolicConstant specifying the units used to describe the dynamic event in the amplitude used for the calculation. Possible values are EVENT_DISPLACEMENT, EVENT_VELOCITY, EVENT_ACCELERATION, and EVENT_GRAVITY. The default value is EVENT_ACCELERATION.

  • solution (SymbolicConstant, default: ABSOLUTE_VALUE) – A SymbolicConstant specifying the solution method for the dynamic equations. Possible values are ABSOLUTE_VALUE and RELATIVE_VALUE. The default value is ABSOLUTE_VALUE.

  • timeIncrement (float, default: 0) – A Float specifying the implicit time increment used to calculate the spectrum. This argument is required when the method = CALCULATE. The default value is 0.0.

  • gravity (float, default: 1) – A Float specifying the acceleration due to gravity. This argument applies only when specificationUnits = GRAVITY or*eventUnits* = GRAVITY. The default value is 1.0.

  • criticalDamping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to calculate the spectrum for only the specified range of critical damping values or a list of values. If criticalDamping = ON, the spectrum is calculated only for the specified range of critical damping values. If criticalDamping = OFF, the spectrum is calculated for a list of damping values. The default value is OFF.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

  • amplitude (str, default: '') – A String specifying the name of the amplitude that describes the dynamic event used to calculate the spectrum. The default value is an empty string.

Returns:

A SpectrumAmplitude object.

Return type:

SpectrumAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

StaticLinearPerturbationStep(name, previous, description='', matrixSolver=abaqusConstants.DIRECT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False)[source]#

This method creates a StaticLinearPerturbationStep object.

Note

This function can be accessed by:

mdb.models[name].StaticLinearPerturbationStep

Note

Check StaticLinearPerturbationStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • matrixSolver (SymbolicConstant, default: DIRECT) – A SymbolicConstant specifying the type of solver. Possible values are DIRECT and ITERATIVE. The default value is DIRECT.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

Returns:

step – A StaticLinearPerturbationStep object.

Return type:

StaticLinearPerturbationStep

StaticRiksStep(name, previous, description='', nlgeom=OFF, adiabatic=OFF, maxLPF=None, nodeOn=OFF, maximumDisplacement=0, dof=0, region=None, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, totalArcLength=1, initialArcInc=None, minArcInc=None, maxArcInc=None, matrixStorage=abaqusConstants.SOLVER_DEFAULT, extrapolation=abaqusConstants.LINEAR, fullyPlastic='', noStop=OFF, maintainAttributes=False, useLongTermSolution=OFF, convertSDI=abaqusConstants.PROPAGATED)[source]#

This method creates a StaticRiksStep object.

Note

This function can be accessed by:

mdb.models[name].StaticRiksStep

Note

Check StaticRiksStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.

  • adiabatic (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to perform an adiabatic stress analysis. The default value is OFF.

  • maxLPF (Optional[float], default: None) – None or a Float specifying the maximum value of the load proportionality factor. The default value is None.

  • nodeOn (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to monitor the finishing displacement value at a node. The default value is OFF.

  • maximumDisplacement (float, default: 0) – A Float specifying the value of the total displacement (or rotation) at the node and degree of freedom that, if crossed during an increment, ends the step at the current increment. This argument is required when nodeOn = ON. The default value is 0.0.

  • dof (int, default: 0) – An Int specifying the degree of freedom being monitored. This argument is required when nodeOn = ON. The default value is 0.

  • region (Optional[Region], default: None) – A Region object specifying the vertex at which the finishing displacement value is being monitored. This argument is required when nodeOn = ON.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • totalArcLength (float, default: 1) – A Float specifying the total load proportionality factor associated with the load in this step. The default value is 1.0.

  • initialArcInc (Optional[float], default: None) – A Float specifying the initial load proportionality factor. The default value is the total load proportionality factor for the step.

  • minArcInc (Optional[float], default: None) – A Float specifying the minimum arc length increment allowed. The default value is the smaller of the suggested initial load proportionality factor or 10−5 times the total load proportionality factor for the step.

  • maxArcInc (Optional[float], default: None) – A Float specifying the maximum arc length increment allowed. The default value is the total load proportionality factor for the step.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • fullyPlastic (str, default: '') – A String specifying the name of the region being monitored for fully Plastic behavior. The default value is an empty string.

  • noStop (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed have been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set noStop = ON only in special cases when you have a thorough understanding of how to interpret the results.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • useLongTermSolution (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying wether to obtain the fully relaxed long-term elastic solution with time-domain viscoelasticity or the long-term elastic-Plastic solution for two-layer viscoplasticity. The default value is OFF.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

Returns:

step – A StaticRiksStep object.

Return type:

StaticRiksStep

StaticStep(name, previous, description='', timePeriod=1, nlgeom=OFF, stabilizationMethod=abaqusConstants.NONE, stabilizationMagnitude=None, adiabatic=OFF, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None, matrixSolver=abaqusConstants.DIRECT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, amplitude=abaqusConstants.RAMP, extrapolation=abaqusConstants.LINEAR, fullyPlastic='', noStop=OFF, maintainAttributes=False, useLongTermSolution=OFF, solutionTechnique=abaqusConstants.FULL_NEWTON, reformKernel=8, convertSDI=abaqusConstants.PROPAGATED, adaptiveDampingRatio=0, continueDampingFactors=OFF)[source]#

This method creates a StaticStep object.

Note

This function can be accessed by:

mdb.models[name].StaticStep

Note

Check StaticStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • timePeriod (float, default: 1) – A Float specifying the total time period. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.

  • stabilizationMethod (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

  • stabilizationMagnitude (Optional[float], default: None) – A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10-4.

  • adiabatic (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to perform an adiabatic stress analysis. The default value is OFF.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10-5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • matrixSolver (SymbolicConstant, default: DIRECT) – A SymbolicConstant specifying the type of solver. Possible values are DIRECT and ITERATIVE. The default value is DIRECT.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • amplitude (SymbolicConstant, default: RAMP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is RAMP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • fullyPlastic (str, default: '') – A String specifying the region being monitored for fully Plastic behavior. The default value is an empty string.

  • noStop (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed has been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set noStop = ON only in special cases when you have a thorough understanding of how to interpret the results.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • useLongTermSolution (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying wether to obtain the fully relaxed long-term elastic solution with time-domain viscoelasticity or the long-term elastic-Plastic solution for two-layer viscoplasticity. The default value is OFF.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the technique used to for solving nonlinear equations. Possible values are FULL_NEWTON and QUASI_NEWTON. The default value is FULL_NEWTON.

  • reformKernel (int, default: 8) – An Int specifying the number of quasi-Newton iterations allowed before the kernel matrix is reformed.. The default value is 8.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

  • adaptiveDampingRatio (float, default: 0) – A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

  • continueDampingFactors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step – A StaticRiksStep object.

Return type:

StaticRiksStep

StdContactControl(name, stiffnessScaleFactor=1, penetrationTolChoice=abaqusConstants.RELATIVE, relativePenetrationTolerance=None, absolutePenetrationTolerance=None, frictionOnset=None, automaticTolerances=OFF, maxchp=0, perrmx=0, uerrmx=0, stabilizeChoice=abaqusConstants.NONE, dampFactor=1, dampCoef=0, tangFraction=1, eosFraction=0, zeroDampingChoice=abaqusConstants.COMPUTE, zeroDamping=None, enforceWithLagrangeMultipliers=abaqusConstants.DEFAULT)[source]#

This method creates an StdContactControl object.

Note

This function can be accessed by:

mdb.models[name].StdContactControl

Note

Check StdContactControl on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the contact controls repository key.

  • stiffnessScaleFactor (float, default: 1) – A Float specifying the factor by which Abaqus/Standard will scale the default penalty stiffness to obtain the stiffnesses used for the contact pairs. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The default value is 1.0.

  • penetrationTolChoice (SymbolicConstant, default: RELATIVE) – A SymbolicConstant specifying whether the allowable penetration is an absolute value or a value relative to the characteristic contact surface face dimension. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. Possible values are RELATIVE and ABSOLUTE. The default value is RELATIVE.

  • relativePenetrationTolerance (Optional[float], default: None) – A Float specifying the ratio of the allowable penetration to the characteristic contact surface face dimension. The float values represent percentages (e.g.: 0.001=0.1%). Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The default value is 10-3.The relativePenetrationTolerance argument applies only when penetrationTolChoice = RELATIVE. The relativePenetrationTolerance and absolutePenetrationTolerance arguments are mutually exclusive.

  • absolutePenetrationTolerance (Optional[float], default: None) – None or a Float specifying the allowable penetration. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The absolutePenetrationTolerance argument applies only when penetrationTolChoice = ABSOLUTE. The relativePenetrationTolerance and absolutePenetrationTolerance arguments are mutually exclusive. The default value is None.

  • frictionOnset (Optional[SymbolicConstant], default: None) –

    A SymbolicConstant specifying when the application of friction occurs. Possible values are:

    • IMMEDIATE, specifying the friction is included in the increment when contact occurs.

    • DELAYED, specifying the application of friction is delayed until the increment after contact occurs.

  • automaticTolerances (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether Abaqus/Standard should automatically compute an overclosure tolerance and a separation tolerance to prevent chattering in contact. The default value is OFF.The automaticTolerances argument cannot be used with the maxchp, perrmx, and uerrmx arguments.

  • maxchp (int, default: 0) – An Int specifying the maximum number of points that are permitted to violate contact conditions in any increment. The default value is 0.Either the perrmx or the uerrmx argument must be specified in conjunction with the maxchp argument.

  • perrmx (float, default: 0) – A Float specifying the maximum value of tensile stress (tensile force in GAP- or ITT-type contact elements) allowed to be transmitted at a contact point. The default value is 0.0.The perrmx argument must be specified in conjunction with the maxchp argument.

  • uerrmx (float, default: 0) – A Float specifying the maximum overclosure distance allowed at a slave node that is considered to be open. The default value is 0.0.The uerrmx argument must be specified in conjunction with the maxchp argument.

  • stabilizeChoice (SymbolicConstant, default: NONE) – A SymbolicConstant specifying whether or not viscous damping will be specified, and if so, how it will be specified. Possible values are NONE, AUTOMATIC, and COEFFICIENT. The default value is NONE.

  • dampFactor (float, default: 1) – A Float specifying the value of the damping factor. This value is multiplied by the calculated damping coefficient. The default value is 1.0.This argument is only valid when stabilizeChoice = AUTOMATIC.

  • dampCoef (float, default: 0) – A Float specifying the damping coefficient. The default value is 0.0.This argument is only valid when stabilizeChoice = COEFFICIENT.

  • tangFraction (float, default: 1) – A Float specifying the tangential stabilization as a fraction of the normal stabilization (damping). The default value is 1.0.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.

  • eosFraction (float, default: 0) – A Float specifying the fraction of the damping that remains at the end of the step. The default value is 0.0.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.

  • zeroDampingChoice (SymbolicConstant, default: COMPUTE) – A SymbolicConstant specifying how the zero-damping clearance will be specified. Possible values are COMPUTE and SPECIFY. The default value is COMPUTE.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.

  • zeroDamping (Optional[float], default: None) – None or a Float specifying the clearance at which damping becomes zero. This argument is valid only when zeroDampingChoice = SPECIFY. This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT. The default value is None.

  • enforceWithLagrangeMultipliers (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying whether to enforce the contact constraints with Lagrange multipliers. Possible values are DEFAULT, ENFORCEMENT_OFF, and ENFORCEMENT_ON. The default value is DEFAULT.

Returns:

A StdContactControl object.

Return type:

StdContactControl

Raises:

RangeError –

StdInitialization(name, overclosureType=abaqusConstants.ADJUST, interferenceDistance=None, clearanceDistance=None, openingTolerance=None, overclosureTolerance=None)[source]#

This method creates a StdInitialization object.

Note

This function can be accessed by:

mdb.models[name].StdInitialization

New in version 2020: The ExpInitialization method was added.

Note

Check StdInitialization on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the contact initialization repository key.

  • overclosureType (SymbolicConstant, default: ADJUST) – A SymbolicConstant specifying the type of overclosure to be defined. Possible values are ADJUST, INTERFERENCE, and CLEARANCE. The default value is ADJUST.

  • interferenceDistance (Optional[float], default: None) – None or a Float specifying the interference distance. This argument is valid only when overclosureType = INTERFERENCE. The default value is None.

  • clearanceDistance (Optional[float], default: None) – None or a Float specifying the initial clearance distance. This argument is valid only when overclosureType = CLEARANCE, and must be specified in that case. The default value is None.

  • openingTolerance (Optional[float], default: None) – None or a Float specifying the distance tolerance within which initial openings will undergo strain-free adjustments. This argument is not valid when overclosureType = INTERFERENCE unless a value has been specified for interferenceDistance. The default value is None.

  • overclosureTolerance (Optional[float], default: None) – None or a Float specifying the distance tolerance within which initial overclosures will undergo strain-free adjustments.. The default value is None.

Returns:

A StdInitialization object.

Return type:

StdInitialization

Raises:

RangeError –

StdStabilization(name, zeroDistance=None, reductionFactor=0, scaleFactor=1, tangentialFactor=0, amplitude='', reset=OFF)[source]#

This method creates a StdStabilization object.

Note

This function can be accessed by:

mdb.models[name].StdStabilization

Note

Check StdStabilization on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the contact stabilization repository key.

  • zeroDistance (Optional[float], default: None) – None or a Float specifying the clearance distance at which the stabilization becomes zero. The default value is None.

  • reductionFactor (float, default: 0) – A Float specifying the factor by which the analysis will reduce the contact stabilization coefficient per increment. The default value is 0.1.

  • scaleFactor (float, default: 1) – A Float specifying the factor by which the analysis will scale the contact stabilization coefficient. The default value is 1.0.

  • tangentialFactor (float, default: 0) – A Float specifying the factor that scales the contact stabilization coefficient in the tangential direction. The default value is 0.0.

  • amplitude (str, default: '') – A String specifying the name of the Amplitude object that defines a time-dependent scale factor for contact stabilization over the step. The default value is an empty string.

  • reset (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to cancel carryover effects from contact stabilization specifications involving nondefault amplitudes that appeared in previous steps. The default value is OFF.

Returns:

A StdStabilization object.

Return type:

StdStabilization

Raises:

RangeError –

StdXplCosimulation(name, createStepName, region, incrementation=abaqusConstants.ALLOW_SUBCYCLING, stepSize=0, stepSizeDefinition=abaqusConstants.DEFAULT)[source]#

This method creates a StdXplCosimulation object.

Note

This function can be accessed by:

mdb.models[name].StdXplCosimulation

Note

Check StdXplCosimulation on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the StdXplCosimulation object is created.

  • region (Region) – A Region object specifying the import and export region upon which the co-simulation exchanges data with the coupled analysis program.

  • incrementation (SymbolicConstant, default: ALLOW_SUBCYCLING) – A SymbolicConstant specifying whether the analysis programs use the same time increments or one is allowed to use more time increments than the other before exchanging data. Possible values are ALLOW_SUBCYCLING and LOCKSTEP. The default value is ALLOW_SUBCYCLING.

  • stepSize (float, default: 0) – A Float specifying the size of the increments to be used by Abaqus/Standard and Abaqus/Explicit. The default value is 0.0.

  • stepSizeDefinition (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying whether the increment size is the analysis default or a supplied variable. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.

Returns:

A StdXplCosimulation object.

Return type:

StdXplCosimulation

SteadyStateDirectStep(name, previous, frequencyRange, description='', factorization=abaqusConstants.COMPLEX, scale=abaqusConstants.LOGARITHMIC, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False, subdivideUsingEigenfrequencies=OFF, frictionDamping=OFF)[source]#

This method creates a SteadyStateDirectStep object.

Note

This function can be accessed by:

mdb.models[name].SteadyStateDirectStep

Note

Check SteadyStateDirectStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • frequencyRange (List[SteadyStateDirectFrequency]) – A SteadyStateDirectFrequencyArray object.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • factorization (SymbolicConstant, default: COMPLEX) – A SymbolicConstant specifying whether damping terms are to be ignored so that a real, rather than a complex, system matrix is factored. Possible values are REAL_ONLY and COMPLEX. The default value is COMPLEX.

  • scale (SymbolicConstant, default: LOGARITHMIC) – A SymbolicConstant specifying whether a logarithmic or linear scale is used for output. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • subdivideUsingEigenfrequencies (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to subdivide each frequency range using the eigenfrequencies of the system. The default value is OFF.

  • frictionDamping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

Returns:

step – A SteadyStateDirectStep object.

Return type:

SteadyStateDirectStep

SteadyStateModalStep(name, previous, frequencyRange, description='', scale=abaqusConstants.LOGARITHMIC, directDamping=None, compositeDamping=None, rayleighDamping=None, structuralDamping=None, directDampingByFrequency=None, rayleighDampingByFrequency=None, structuralDampingByFrequency=None, maintainAttributes=False, subdivideUsingEigenfrequencies=ON)[source]#

This method creates a SteadyStateModalStep object.

Note

This function can be accessed by:

mdb.models[name].SteadyStateModalStep

Note

Check SteadyStateModalStep on help.3ds.com/2021.

Parameters:
Returns:

step – A SteadyStateModalStep object.

Return type:

SteadyStateModalStep

SteadyStateSubspaceStep(name, previous, frequencyRange, description='', factorization=abaqusConstants.COMPLEX, scale=abaqusConstants.LOGARITHMIC, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False, subdivideUsingEigenfrequencies=ON, projection=abaqusConstants.ALL_FREQUENCIES, maxDampingChange=0, maxStiffnessChange=0, frictionDamping=OFF)[source]#

This method creates a SteadyStateSubspaceStep object.

Note

This function can be accessed by:

mdb.models[name].SteadyStateSubspaceStep

Note

Check SteadyStateSubspaceStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • frequencyRange (List[SteadyStateSubspaceFrequency]) – A SteadyStateSubspaceFrequencyArray object.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • factorization (SymbolicConstant, default: COMPLEX) – A SymbolicConstant specifying whether damping terms are to be ignored so that a real, rather than a complex, system matrix is factored. Possible values are REAL_ONLY and COMPLEX. The default value is COMPLEX.

  • scale (SymbolicConstant, default: LOGARITHMIC) – A SymbolicConstant specifying whether a logarithmic or linear scale is used for output. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • subdivideUsingEigenfrequencies (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to subdivide each frequency range using the eigenfrequencies of the system. The default value is ON.

  • projection (SymbolicConstant, default: ALL_FREQUENCIES) – A SymbolicConstant specifying how often to perform subspace projections onto the modal subspace. Possible values are ALL_FREQUENCIES, CONSTANT, EIGENFREQUENCY, PROPERTY_CHANGE, and RANGE. The default value is ALL_FREQUENCIES.

  • maxDampingChange (float, default: 0) – A Float specifying the maximum relative change in damping material properties before a new projection is to be performed. The default value is 0.1.

  • maxStiffnessChange (float, default: 0) – A Float specifying the maximum relative change in stiffness material properties before a new projection is to be performed. The default value is 0.1.

  • frictionDamping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

Returns:

step – A SteadyStateSubspaceStep object.

Return type:

SteadyStateSubspaceStep

Stress(name, region, distributionType=abaqusConstants.UNIFORM, sigma11=None, sigma22=None, sigma33=None, sigma12=None, sigma13=None, sigma23=None)[source]#

This method creates a Stress predefined field object.

Note

This function can be accessed by:

mdb.models[name].Stress

New in version 2017: The Stress method was added.

Note

Check Stress on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • region (Region) – A Region object specifying the region to which the predefined field is applied. Region is ignored if the predefined field has distributionType = FROM_FILE.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM and FROM_FILE. The default value is UNIFORM.

  • sigma11 (Optional[float], default: None) – A Float specifying the first principal component of the stress.

  • sigma22 (Optional[float], default: None) – A Float specifying the second principal component of the stress.

  • sigma33 (Optional[float], default: None) – A Float specifying the third principal component of the stress.

  • sigma12 (Optional[float], default: None) – A Float specifying the first shear component of the stress.

  • sigma13 (Optional[float], default: None) – A Float specifying the second shear component of the stress.

  • sigma23 (Optional[float], default: None) – A Float specifying the third shear component of the stress.

Return type:

A Stress object.

SubmodelBC(name, createStepName, region, dof, globalStep, timeScale, shellThickness, globalDrivingRegion='', absoluteExteriorTolerance=None, exteriorTolerance=0, localCsys=None, globalIncrement=0, centerZoneSize=None, intersectionOnly=OFF)[source]#

This method creates a SubmodelBC object.

Note

This function can be accessed by:

mdb.models[name].SubmodelBC

Note

Check SubmodelBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • dof (tuple) – A sequence of Ints specifying the degrees of freedom to which the boundary condition is applied.

  • globalStep (str) – A String specifying the step in the global model from which Abaqus reads the values of the variables that will drive the submodel analysis. The String indicates the position of the step in the sequence of analysis steps. For example, globalStep = ‘1’ indicates the first step.

  • timeScale (Union[AbaqusBoolean, bool]) – A Boolean specifying whether to scale the time variable for the driven nodes’ amplitude functions to match the submodel analysis step time. The default value is OFF.

  • shellThickness (float) – A Float specifying the thickness of the shell in the global model. This argument is required for shell-to-solid submodeling and is not applicable to other submodels. The default value is 0.0.

  • globalDrivingRegion (str, default: '') – A String specifying the element set in the global model that will be searched for elements whose responses will be used to drive the submodel. An empty string indicates that the entire global model will be searched. The default value is an empty string.

  • absoluteExteriorTolerance (Optional[float], default: None) – None or a Float specifying the absolute value by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is None.

  • exteriorTolerance (float, default: 0) – None or a Float specifying the fraction of the average element size in the global model by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is 0.05.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

  • globalIncrement (int, default: 0) – An Int specifying the increment number in the global model step from which the solution will be used to specify the values of the driven variables. If globalIncrement = 0, the solution from the last increment will be used. The globalIncrement argument is applicable only for linear perturbation steps. The default value is 0.

  • centerZoneSize (Optional[float], default: None) – A Float specifying the thickness of the center zone size around the shell midsurface. The default value is None.

  • intersectionOnly (Union[AbaqusBoolean, bool], default: OFF) –

    A Boolean specifying whether to ignore driven nodes that lie outside the region of elements of the global model after accounting for the exterior search tolerance. The default value is OFF.

    New in version 2021: The intersectionOnly argument was added.

Returns:

bc – A SubmodelBC object.

Return type:

SubmodelBC

SubmodelSB(name, createStepName, region, globalStep, globalDrivingRegion='', absoluteExteriorTolerance=None, exteriorTolerance=0, globalIncrement=0)[source]#

This method creates a SubmodelSB object.

Note

This function can be accessed by:

mdb.models[name].SubmodelSB

Note

Check SubmodelSB on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • globalStep (str) – A String specifying the step in the global model from which Abaqus reads the values of the variables that will drive the submodel analysis. The String indicates the position of the step in the sequence of analysis steps. For example, globalStep = ‘1’ indicates the first step.

  • globalDrivingRegion (str, default: '') – A String specifying the element set in the global model that will be searched for elements whose responses will be used to drive the submodel. An empty string indicates that the entire global model will be searched. The default value is an empty string.

  • absoluteExteriorTolerance (Optional[float], default: None) – None or a Float specifying the absolute value by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is None.

  • exteriorTolerance (float, default: 0) – None or a Float specifying the fraction of the average element size in the global model by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is 0.05.

  • globalIncrement (int, default: 0) – An Int specifying the increment number in the global model step from which the solution will be used to specify the values of the driven variables. If globalIncrement = 0, the solution from the last increment will be used. The globalIncrement argument is applicable only for linear perturbation steps. The default value is 0.

Returns:

A SubmodelSB object.

Return type:

SubmodelSB

SubspaceDynamicsStep(name, previous, description='', timePeriod=1, vectors=abaqusConstants.ALL, nlgeom=OFF, maxNumInc=100, incSize=0, amplitude=abaqusConstants.STEP, maintainAttributes=False)[source]#

This method creates a SubspaceDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].SubspaceDynamicsStep

Note

Check SubspaceDynamicsStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • timePeriod (float, default: 1) – A Float specifying the total time period of the step. The default value is 1.0.

  • vectors (SymbolicConstant, default: ALL) – The SymbolicConstant ALL or an Int specifying the number of modes to be used for subspace projection. The possible value for the SymbolicConstant is ALL. The default value is ALL.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • incSize (float, default: 0) – A Float specifying the suggested time increment. The default value is 0.0.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

Returns:

step – A SubspaceDynamicsStep object.

Return type:

SubspaceDynamicsStep

SubstructureGenerateStep(name, previous, substructureIdentifier, description='', recoveryMatrix=abaqusConstants.WHOLE_MODEL, recoveryRegion=None, computeGravityLoadVectors=False, computeReducedMassMatrix=False, computeReducedStructuralDampingMatrix=False, computeReducedViscousDampingMatrix=False, evaluateFrequencyDependentProperties=False, frequency=0, retainedEigenmodesMethod=abaqusConstants.NONE, modeRange=None, frequencyRange=None, globalDampingField=abaqusConstants.NONE, alphaDampingRatio=0, betaDampingRatio=0, structuralDampingRatio=0, viscousDampingControl=abaqusConstants.NONE, structuralDampingControl=abaqusConstants.NONE)[source]#

This method creates a SubstructureGenerateStep object.

Note

This function can be accessed by:

mdb.models[name].SubstructureGenerateStep

Note

Check SubstructureGenerateStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • substructureIdentifier (int) – An Integer specifying a unique identifier for the substructure.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • recoveryMatrix (SymbolicConstant, default: WHOLE_MODEL) – A SymbolicConstant specifying the subtructure recovery to be computed. Possible values are WHOLE_MODEL, REGION, and NONE. The default value is WHOLE_MODEL.

  • recoveryRegion (Optional[Region], default: None) – A Region object specifying the region for substructure recovery. This argument is required when recoveryMatrix = REGION.

  • computeGravityLoadVectors (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to compute the gravity load vectors. The default value is False.

  • computeReducedMassMatrix (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to compute the reduced mass matrix. The default value is False.

  • computeReducedStructuralDampingMatrix (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to compute the reduced structural damping matrix. The default value is False.

  • computeReducedViscousDampingMatrix (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to compute the reduced viscous damping matrix. The default value is False.

  • evaluateFrequencyDependentProperties (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to evaluate the frequency dependent properties. The default value is False.

  • frequency (float, default: 0) – A Float specifying the frequency at which to evaluate the frequency dependent properties. The default value is 0.0.

  • retainedEigenmodesMethod (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the eigenmodes to be retained. Possible values are MODE_RANGE, FREQUENCY_RANGE, and NONE. The default value is NONE.

  • modeRange (Optional[List[SubstructureGenerateModes]], default: None) – A SubstructureGenerateModesArray object.

  • frequencyRange (Optional[List[SubstructureGenerateFrequency]], default: None) – A SubstructureGenerateFrequencyArray object.

  • globalDampingField (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the field to which the global damping factors should be applied. Possible values are ALL, ACOUSTIC, MECHANICAL, and NONE. The default value is NONE.

  • alphaDampingRatio (float, default: 0) – A Float specifying the factor to create global Rayleigh mass proportional damping. The default value is 0.0.

  • betaDampingRatio (float, default: 0) – A Float specifying the factor to create global Rayleigh stiffness proportional damping. The default value is 0.0.

  • structuralDampingRatio (float, default: 0) – A Float specifying the factor to create frequency-independent stiffness proportional structural damping. The default value is 0.0.

  • viscousDampingControl (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the damping control to include the viscous damping matrix. Possible values are ELEMENT, FACTOR, COMBINED, and NONE. The default value is NONE.

  • structuralDampingControl (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the damping control to include the structural damping matrix. Possible values are ELEMENT, FACTOR, COMBINED, and NONE. The default value is NONE.

Returns:

step – A SubstructureGenerateStep object.

Return type:

SubstructureGenerateStep

SubstructureLoad(name, createStepName, region, loadCaseNames, magnitude, amplitude=abaqusConstants.UNSET)[source]#

This method creates a SubstructureLoad object.

Note

This function can be accessed by:

mdb.models[name].SubstructureLoad

Note

Check SubstructureLoad on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the substructure load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • loadCaseNames (str) – A list of names of the load cases that should be activated by this substructure load.

  • magnitude (float) – A Float specifying the multiplier for the load case magnitude.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SubstructureLoad object.

Return type:

SubstructureLoad

SurfaceCharge(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET)[source]#

This method creates a SurfaceCharge object.

Note

This function can be accessed by:

mdb.models[name].SurfaceCharge

Note

Check SurfaceCharge on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceCharge object.

Return type:

SurfaceCharge

SurfaceConcentrationFlux(name, createStepName, region, magnitude, field='', distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET)[source]#

This method creates a SurfaceConcentrationFlux object.

Note

This function can be accessed by:

mdb.models[name].SurfaceConcentrationFlux

Note

Check SurfaceConcentrationFlux on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the surface concentration flux magnitude. magnitude is optional if distributionType = USER_DEFINED.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the surface concentration flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceConcentrationFlux object.

Return type:

SurfaceConcentrationFlux

SurfaceCurrent(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET)[source]#

This method creates a SurfaceCurrent object.

Note

This function can be accessed by:

mdb.models[name].SurfaceCurrent

Note

Check SurfaceCurrent on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceCurrent object.

Return type:

SurfaceCurrent

SurfaceCurrentDensity(name, createStepName, region, comp1, comp2, comp3, distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET)[source]#

This method creates a SurfaceCurrentDensity object.

Note

This function can be accessed by:

mdb.models[name].SurfaceCurrentDensity

Note

Check SurfaceCurrentDensity on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • comp1 (str) – A Complex specifying the first component of the load.

  • comp2 (str) – A Complex specifying the second component of the load.

  • comp3 (str) – A Complex specifying the third component of the load.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceCurrentDensity object.

Return type:

SurfaceCurrentDensity

SurfaceHeatFlux(name, createStepName, region, magnitude, field='', distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET)[source]#

This method creates a SurfaceHeatFlux object.

Note

This function can be accessed by:

mdb.models[name].SurfaceHeatFlux

Note

Check SurfaceHeatFlux on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the surface heat flux magnitude. magnitude is optional if distributionType = USER_DEFINED.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the surface heat flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceHeatFlux object.

Return type:

SurfaceHeatFlux

SurfacePoreFluid(name, createStepName, region, magnitude, field='', distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET)[source]#

This method creates a SurfacePoreFluid object.

Note

This function can be accessed by:

mdb.models[name].SurfacePoreFluid

Note

Check SurfacePoreFluid on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the surface pore fluid flow magnitude. magnitude is optional if distributionType = USER_DEFINED.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfacePoreFluid object.

Return type:

SurfacePoreFluid

SurfaceSection(name, useDensity=OFF, density=0)[source]#

This method creates a SurfaceSection object.

Note

This function can be accessed by:

mdb.models[name].SurfaceSection
session.odbs[name].SurfaceSection

Note

Check SurfaceSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • useDensity (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not to use the value of density. The default value is OFF.

  • density (float, default: 0) – A Float specifying the value of density to apply to this section. The default value is 0.0.

Returns:

A SurfaceSection object.

Return type:

SurfaceSection

Raises:

RangeError –

SurfaceToSurfaceContactExp(name, createStepName, master, slave, sliding, interactionProperty, mechanicalConstraint=abaqusConstants.KINEMATIC, weightingFactorType=abaqusConstants.DEFAULT, weightingFactor=0, contactControls='', initialClearance=abaqusConstants.OMIT, halfThreadAngle=None, pitch=None, majorBoltDiameter=abaqusConstants.COMPUTED, meanBoltDiameter=abaqusConstants.COMPUTED, datumAxis=None, useReverseDatumAxis=OFF, clearanceRegion=None)[source]#

This method creates a SurfaceToSurfaceContactExp object.

Note

This function can be accessed by:

mdb.models[name].SurfaceToSurfaceContactExp

Note

Check SurfaceToSurfaceContactExp on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the SurfaceToSurfaceContactExp object is created.

  • master (Region) – A Region object specifying the main surface.

  • slave (Region) – A Region object specifying the secondary surface.

  • sliding (SymbolicConstant) – A SymbolicConstant specifying the contact formulation. Possible values are FINITE and SMALL.

  • interactionProperty (str) – A String specifying the name of the ContactProperty object associated with this interaction.

  • mechanicalConstraint (SymbolicConstant, default: KINEMATIC) – A SymbolicConstant specifying the mechanical constraint formulation. Possible values are KINEMATIC and PENALTY. The default value is KINEMATIC.

  • weightingFactorType (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the weighting for node-to-face contact. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.

  • weightingFactor (float, default: 0) – A Float specifying the weighting factor for the contact surfaces when weightingFactorType = SPECIFIED. The default value is 0.0.

  • contactControls (str, default: '') – A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.

  • initialClearance (Union[SymbolicConstant, float], default: OMIT) – A SymbolicConstant or a Float specifying the initial clearance at regions of contact. Possible values are OMIT and COMPUTED. The default value is OMIT.

  • halfThreadAngle (Optional[str], default: None) – None or a sequence of Floats specifying the half thread angle used for bolt clearance. The default value is None.

  • pitch (Optional[str], default: None) – None or a sequence of Floats specifying the pitch used for bolt clearance. The default value is None.

  • majorBoltDiameter (Union[SymbolicConstant, float], default: COMPUTED) – The SymbolicConstant COMPUTED or a Float specifying the major diameter of the bolt used for bolt clearance. The default value is COMPUTED.

  • meanBoltDiameter (Union[SymbolicConstant, float], default: COMPUTED) – The SymbolicConstant COMPUTED or a Float specifying the mean diameter of the bolt used for bolt clearance. The default value is COMPUTED.

  • datumAxis (Optional[DatumAxis], default: None) – A DatumAxis object specifying the orientation of the bolt hole when specifying bolt clearance.

  • useReverseDatumAxis (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to reverse the bolt clearance direction given by the datum axis. The default value is OFF.

  • clearanceRegion (Optional[Region], default: None) – A Region object specifying the contact region for which clearance is specified.

Returns:

A SurfaceToSurfaceContactExp object.

Return type:

SurfaceToSurfaceContactExp

SurfaceToSurfaceContactStd(name, createStepName, master, slave, sliding, interactionProperty, interferenceType=abaqusConstants.NONE, overclosure=0, interferenceDirectionType=abaqusConstants.COMPUTED, direction=(), amplitude='', smooth=0, hcrit=0, extensionZone=0, adjustMethod=abaqusConstants.NONE, adjustTolerance=0, adjustSet=None, enforcement=abaqusConstants.SURFACE_TO_SURFACE, thickness=ON, contactControls='', tied=OFF, initialClearance=abaqusConstants.OMIT, halfThreadAngle=None, pitch=None, majorBoltDiameter=abaqusConstants.COMPUTED, meanBoltDiameter=abaqusConstants.COMPUTED, datumAxis=None, useReverseDatumAxis=OFF, clearanceRegion=None, surfaceSmoothing=abaqusConstants.NONE, bondingSet=None, handedness=abaqusConstants.RIGHT, normalAdjustment=None)[source]#

This method creates a SurfaceToSurfaceContactStd object.

Note

This function can be accessed by:

mdb.models[name].SurfaceToSurfaceContactStd

Note

Check SurfaceToSurfaceContactStd on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the SurfaceToSurfaceContactStd object is created.

  • master (Region) – A Region object specifying the master surface.

  • slave (Region) – A Region object specifying the slave surface.

  • sliding (SymbolicConstant) – A SymbolicConstant specifying the contact formulation. Possible values are FINITE and SMALL.

  • interactionProperty (str) – A String specifying the name of the ContactProperty object associated with this interaction.

  • interferenceType (SymbolicConstant, default: NONE) –

    A SymbolicConstant specifying the type of time-dependent allowable interference for contact pairs and contact elements. Possible values are:

    • NONE, specifying no allowable contact interference.

    • SHRINK_FIT.

    • UNIFORM.

    The default value is NONE.

  • overclosure (float, default: 0) – A Float specifying the maximum overclosure distance allowed. This argument applies only when interferenceType = UNIFORM. The default value is 0.0.

  • interferenceDirectionType (SymbolicConstant, default: COMPUTED) – A SymbolicConstant specifying the method used to determine the interference direction. Possible values are COMPUTED and DIRECTION_COSINE. The default value is COMPUTED.

  • direction (tuple, default: ()) –

    A sequence of three Floats specifying the following:

    • XX-direction cosine of the interference direction vector.

    • YY-direction cosine of the interference direction vector.

    • ZZ-direction cosine of the interference direction vector.

    This argument is required only when interferenceDirectionType = DIRECTION_COSINE.

  • amplitude (str, default: '') – A String specifying the name of the amplitude curve that defines the magnitude of the prescribed interference during the step. Use None to specify that the prescribed interference is applied immediately at the beginning of the step and ramped down to zero linearly over the step.

  • smooth (float, default: 0) – A Float specifying the degree of smoothing used for deformable or rigid master surfaces involved when enforcement = NODE_TO_SURFACE. The value given must lie between 0.0 and 0.5. The default value is 0.2.

  • hcrit (float, default: 0) – A Float specifying the distance by which a slave node must penetrate the master surface before Abaqus/Standard abandons the current increment and tries again with a smaller increment. The default value is 0.0.

  • extensionZone (float, default: 0) – A Float specifying a fraction of the end segment or facet edge length by which the master surface is to be extended to avoid numerical round-off errors associated with contact modeling. The value given must lie between 0.0 and 0.2. The default value is 0.1.

  • adjustMethod (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the adjust method. Possible values are NONE, OVERCLOSED, TOLERANCE, and SET. The default value is NONE.

  • adjustTolerance (float, default: 0) – A Float specifying the adjust tolerance. The default value is 0.0.

  • adjustSet (Optional[Region], default: None) – A Region object specifying the Set object to which the adjustment is to be applied.

  • enforcement (SymbolicConstant, default: SURFACE_TO_SURFACE) – A SymbolicConstant specifying the discretization method. Possible values are NODE_TO_SURFACE and SURFACE_TO_SURFACE. The default value is SURFACE_TO_SURFACE.

  • thickness (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether shell/membrane element thickness is considered. The default value is ON.This argument is not valid when sliding = FINITE and enforcement = NODE_TO_SURFACE.

  • contactControls (str, default: '') – A String specifying the name of the ContactControl object associated with this interaction. The empty string indicates that the default contact controls will be used. The default value is an empty string.

  • tied (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the surfaces are to be “tied” together for the duration of the simulation. The default value is OFF.

  • initialClearance (Union[SymbolicConstant, float], default: OMIT) – A SymbolicConstant or a Float specifying the initial clearance at regions of contact. Possible values are OMIT and COMPUTED. The default value is OMIT.

  • halfThreadAngle (Optional[str], default: None) – None or a sequence of Floats specifying the half thread angle used for bolt clearance. The default value is None.

  • pitch (Optional[str], default: None) – None or a sequence of Floats specifying the pitch used for bolt clearance. The default value is None.

  • majorBoltDiameter (Union[SymbolicConstant, float], default: COMPUTED) – The SymbolicConstant COMPUTED or a Float specifying the major diameter of the bolt used for bolt clearance. The default value is COMPUTED.

  • meanBoltDiameter (Union[SymbolicConstant, float], default: COMPUTED) – The SymbolicConstant COMPUTED or a Float specifying the mean diameter of the bolt used for bolt clearance. The default value is COMPUTED.

  • datumAxis (Optional[DatumAxis], default: None) – A DatumAxis object specifying the orientation of the bolt hole when specifying bolt clearance.

  • useReverseDatumAxis (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to reverse the bolt clearance direction given by the datum axis. The default value is OFF.

  • clearanceRegion (Optional[Region], default: None) – A Region object specifying the contact region for which clearance is specified.

  • surfaceSmoothing (SymbolicConstant, default: NONE) – A SymbolicConstant specifying whether to use surface smoothing for geometric surfaces in SurfaceToSurfaceContactStd interactions. Possible values are AUTOMATIC and NONE. The default value is NONE.

  • bondingSet (Optional[Region], default: None) – A Region object specifying the slave node sub-set for bonding, used only when the contact property CohesiveBehavior option specifies use.

  • handedness (SymbolicConstant, default: RIGHT) –

    A SymbolicConstant specifying the bolt handedness formulation. Possible values are RIGHT and LEFT. The default value is RIGHT.

    New in version 2019: The normalAdjustment argument was added.

  • normalAdjustment (Optional[SymbolicConstant], default: None) –

    A SymbolicConstant specifying the bolt normal adjustment formulation for all slave nodes. Possible values are UNIFORM AXIAL COMPONENT and LOCATION DEPENDENT. The default value is UNIFORM AXIAL COMPONENT.

    New in version 2019: The normalAdjustment argument was added.

Returns:

A SurfaceToSurfaceContactStd object.

Return type:

SurfaceToSurfaceContactStd

SurfaceTraction(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET, angle=0, axis=abaqusConstants.AXIS_1, localCsys=None, userCsys='', directionVector=(), follower=ON, resultant=OFF, traction=abaqusConstants.SHEAR)[source]#

This method creates a SurfaceTraction object.

Note

This function can be accessed by:

mdb.models[name].SurfaceTraction

Note

Check SurfaceTraction on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float or Complex specifying the load magnitude. magnitude is optional if distributionType = USER_DEFINED.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the surface traction is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • angle (float, default: 0) – A Float specifying an additional rotation of directionVector about an axis. The default value is 0.0.

  • axis (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis about which to apply an additional rotation of directionVector. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

  • localCsys (Optional[int], default: None) – None or a DatumCsys object specifying the local coordinate system of the load’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system or by the userCsys parameter if defined. When this member is queried, it returns an Int. The default value is None.

  • userCsys (str, default: '') – A String specifying a CSYS defined by a user-subroutine. If userCsys = None, the degrees of freedom are defined in the global coordinate system or by the localCsys parameter if defined. The default value is “None”.

  • directionVector (tuple, default: ()) – A VertexArray object of length 2 specifying the direction of the load. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. If traction is SHEAR, then directionVector will be projected onto the region surface. This parameter is available only if traction is GENERAL or SHEAR.

  • follower (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the direction of the force changes with rotation. The default value is ON.This parameter may be modified only if traction is GENERAL. You should provide the follower argument only if it is valid for the specified step.

  • resultant (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the to maintain a constant resultant force by defining traction per unit undeformed area. If resultant is OFF, traction is defined per unit deformed area. The default value is OFF.You should provide the resultant argument only if it is valid for the specified step.

  • traction (SymbolicConstant, default: SHEAR) – A SymbolicConstant specifying how to apply surface traction. Possible values are SHEAR and GENERAL. The default value is SHEAR.

Returns:

A SurfaceTraction object.

Return type:

SurfaceTraction

TProfile(name, b, h, l, tf, tw)[source]#

This method creates a TProfile object.

Note

This function can be accessed by:

mdb.models[name].TProfile
session.odbs[name].TProfile

Note

Check TProfile on help.3ds.com/2021.

Parameters:
Returns:

A TProfile object.

Return type:

TProfile

Raises:

RangeError –

TabularAmplitude(name, data, smooth=abaqusConstants.SOLVER_DEFAULT, timeSpan=abaqusConstants.STEP)[source]#

This method creates a TabularAmplitude object.

Note

This function can be accessed by:

mdb.models[name].TabularAmplitude
session.odbs[name].TabularAmplitude

Note

Check TabularAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • data (tuple) – A sequence of pairs of Floats specifying time/frequency and amplitude pairs. Possible values for time/frequency are positive numbers.

  • smooth (Union[SymbolicConstant, float], default: SOLVER_DEFAULT) – The SymbolicConstant SOLVER_DEFAULT or a Float specifying the degree of smoothing. Possible float values are between 0 and 0.5. If smooth = SOLVER_DEFAULT, the default degree of smoothing will be determined by the solver. The default value is SOLVER_DEFAULT.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A TabularAmplitude object.

Return type:

TabularAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

TempDisplacementDynamicsStep(name, previous, description='', timePeriod=1, nlgeom=OFF, timeIncrementationMethod=abaqusConstants.AUTOMATIC_GLOBAL, maxIncrement=None, scaleFactor=1, userDefinedInc=None, massScaling=abaqusConstants.PREVIOUS_STEP, linearBulkViscosity=0, quadBulkViscosity=1, maintainAttributes=False, improvedDtMethod=ON)[source]#

This method creates a TempDisplacementDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].TempDisplacementDynamicsStep

Note

Check TempDisplacementDynamicsStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • timePeriod (float, default: 1) – A Float specifying the time period of the step. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC_GLOBAL) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are AUTOMATIC_GLOBAL, AUTOMATIC_EBE, FIXED_USER_DEFINED_INC, and FIXED_EBE. The default value is AUTOMATIC_GLOBAL.

  • maxIncrement (Optional[float], default: None) – None or a Float specifying the maximum time increment allowed. If there is no upper limit, maxIncrement = None. The default value is None.

  • scaleFactor (float, default: 1) – A Float specifying the factor that is used to scale the time increment. This argument is required only when timeIncrementationMethod = AUTOMATIC_GLOBAL, AUTOMATIC_EBE, or FIXED_EBE. The default value is 1.0.

  • userDefinedInc (Optional[float], default: None) – None or a Float specifying the user-defined time increment. The default value is None.

  • massScaling (List[MassScaling], default: PREVIOUS_STEP) – A MassScalingArray object specifying mass scaling controls. The default value is PREVIOUS_STEP.

  • linearBulkViscosity (float, default: 0) – A Float specifying the linear bulk viscosity parameter, b1b1. The default value is 0.06.

  • quadBulkViscosity (float, default: 1) – A Float specifying the quadratic bulk viscosity parameter, b2b2. The default value is 1.2.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • improvedDtMethod (Union[AbaqusBoolean, bool], default: ON) –

    A Boolean specifying whether to use the “improved” (improvedDtMethod = ON) or “conservative” (improvedDtMethod = OFF) method to estimate the element stable time increment for three-dimensional continuum elements and elements with plane stress formulations (shell, membrane, and two-dimensional plane stress elements). The default value is ON.

    New in version 2018: The improvedDtMethod argument was added.

Returns:

step – A TempDisplacementDynamicsStep object.

Return type:

TempDisplacementDynamicsStep

Temperature(name, createStepName, region, distributionType=abaqusConstants.UNIFORM, crossSectionDistribution=abaqusConstants.CONSTANT_THROUGH_THICKNESS, field='', amplitude=abaqusConstants.UNSET, fileName='', beginStep=None, beginIncrement=None, endStep=None, endIncrement=None, interpolate=OFF, magnitudes='', absoluteExteriorTolerance=0, exteriorTolerance=0)[source]#

This method creates a Temperature object.

Note

This function can be accessed by:

mdb.models[name].Temperature

Note

Check Temperature on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the predefined field is created.

  • region (Region) – A Region object specifying the region to which the predefined field is applied. Region is ignored if the predefined field has a distributionType member available, and distributionType = FROM_FILE .

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the predefined field varies spatially. Possible values are UNIFORM, USER_DEFINED, FROM_FILE, FIELD, FROM_FILE_AND_USER_DEFINED, and DISCRETE_FIELD. The default value is UNIFORM.

  • crossSectionDistribution (SymbolicConstant, default: CONSTANT_THROUGH_THICKNESS) –

    A SymbolicConstant specifying how the predefined field is distributed over the cross section of the region. Possible values are

    • CONSTANT_THROUGH_THICKNESS

    • GRADIENTS_THROUGH_SHELL_CS

    • GRADIENTS_THROUGH_BEAM_CS

    • POINTS_THROUGH_SECTION

    The default value is CONSTANT_THROUGH_THICKNESS.

  • field (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object associated with this predefined field. The field argument applies only when distributionType = FIELD or distributionType = DISCRETE_FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the predefined field has no amplitude reference. The default value is UNSET.Note:amplitude should be given only if it is valid for the specified step.

  • fileName (str, default: '') – A String specifying the name of the file from which the temperature values are to be read when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.

  • beginStep (Optional[SymbolicConstant], default: None) – An Int specifying the first step from which temperature values are to be read or the SymbolicConstant FIRST_STEP or LAST_STEP. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • beginIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the first increment of the step set in beginStep or the SymbolicConstants STEP_START or STEP_END. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • endStep (Optional[SymbolicConstant], default: None) – An Int specifying the last step from which temperature values are to be read or the SymbolicConstants FIRST_STEP and LAST_STEP. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • endIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the last increment of the step set in endStep or the SymbolicConstants STEP_START and STEP_END. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • interpolate (SymbolicConstant, default: OFF) – A SymbolicConstant specifying whether to interpolate a field read from an output database or results file. Possible values are OFF, ON or MIDSIDE_ONLY. The default value is OFF.

  • magnitudes (str, default: '') –

    A Sequence of Doubles specifying the temperature values when distributionType = UNIFORM or FIELD. The value of the magnitudes argument is a function of the crossSectionDistribution argument, as shown in the following list:

    • If crossSectionDistribution = CONSTANT_THROUGH_THICKNESS then magnitudes is a Double specifying the temperature.

    • If crossSectionDistribution = GRADIENTS_THROUGH_SHELL_CS then magnitudes is a sequence of Doubles specifying the mean value and the gradient in the thickness direction.

    • If crossSectionDistribution = GRADIENTS_THROUGH_BEAM_CS then magnitudes is a sequence of Doubles specifying the mean value, the gradient in the N1 direction, and the gradient in the N2 direction.

    • If crossSectionDistribution = POINTS_THROUGH_SECTION then magnitudes is a sequence of Doubles specifying the temperature at each point.

  • absoluteExteriorTolerance (float, default: 0) – A Float specifying the absolute value by which a driven node of the field can lie outside the region of the elements of the global model. The default value is 0.0. This argument cannot be used with midside.

  • exteriorTolerance (float, default: 0) – A Float specifying the fraction of the average element size in the global model by which a driven node of the field can lie outside the region of the elements of the global model. The default value is 0.0. This argument cannot be used with midside.

Returns:

A Temperature object.

Return type:

Temperature

TemperatureBC(name, createStepName, region, fieldName='', magnitude=0, dof=(), amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, fixed=OFF)[source]#

This method creates a TemperatureBC object.

Note

This function can be accessed by:

mdb.models[name].TemperatureBC

Note

Check TemperatureBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • magnitude (float, default: 0) – A Float specifying the temperature magnitude. The default value is 0.

  • dof (tuple, default: ()) – A sequence of Ints specifying the degrees of freedom to which the boundary condition is applied. The default value is (11,).

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A TemperatureBC object.

Return type:

TemperatureBC

Tie(name, master, slave, adjust=ON, positionToleranceMethod=abaqusConstants.COMPUTED, positionTolerance=0, tieRotations=ON, constraintRatioMethod=abaqusConstants.DEFAULT, constraintRatio=0, constraintEnforcement=abaqusConstants.SOLVER_DEFAULT, thickness=ON)[source]#

This method creates a Tie object.

Note

This function can be accessed by:

mdb.models[name].Tie

Note

Check Tie on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • master (Region) – A Region object specifying the name of the master surface.

  • slave (Region) – A Region object specifying the name of the slave surface.

  • adjust (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether initial positions of tied slave nodes are adjusted to lie on the master surface. The default value is ON.

  • positionToleranceMethod (SymbolicConstant, default: COMPUTED) – A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED and SPECIFIED. The default value is COMPUTED.

  • positionTolerance (float, default: 0) – A Float specifying the position tolerance. The positionTolerance argument applies only when positionToleranceMethod = SPECIFIED. The default value is 0.0.

  • tieRotations (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether rotation degrees of freedom should be tied. The default value is ON.

  • constraintRatioMethod (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the method used to determine the constraint ratio. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.

  • constraintRatio (float, default: 0) – A Float specifying the fractional distance between the master reference surface and the slave node at which the translational constraint should act. The constraintRatio argument applies only when constraintRatioMethod = SPECIFIED. The default value is 0.0.

  • constraintEnforcement (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the discretization method. Possible values are SOLVER_DEFAULT, NODE_TO_SURFACE, and SURFACE_TO_SURFACE. The default value is SOLVER_DEFAULT.

  • thickness (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether shell element thickness is considered. The default value is ON.

Returns:

A Tie object.

Return type:

Tie

TimePoint(name, points)[source]#

This method creates a TimePoint object.

Note

This function can be accessed by:

mdb.models[name].TimePoint

Note

Check TimePoint on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • points (tuple) – A sequence of sequences of Floats specifying time points at which data are written to the output database or restart files.

Returns:

A TimePoint object.

Return type:

TimePoint

Raises:

  • InvalidNameError –

  • RangeError –

TopologyTask(name, abaqusSensitivities=True, algorithm=abaqusConstants.GENERAL_OPTIMIZATION, densityMoveLimit=0, densityUpdateStrategy=abaqusConstants.NORMAL, elementDensityDeltaStopCriteria=0, filterRadius=None, firstCycleDeletedVolume=5, firstCycleDeletedVolumeTechnique=OFF, freezeBoundaryConditionRegions=OFF, freezeLoadRegions=ON, frequencySpectrumWeight=6, initialDensity=abaqusConstants.DEFAULT, materialInterpolationPenalty=3, materialInterpolationTechnique=abaqusConstants.DEFAULT, maxDensity=1, minDensity=None, modeTrackingRegion=abaqusConstants.MODEL, numDesignCycles=15, numFulfilledStopCriteria=2, numTrackedModes=5, objectiveFunctionDeltaStopCriteria=None, region=abaqusConstants.MODEL, softDeletionMethod=abaqusConstants.STANDARD, softDeletionRadius=0, softDeletionRegion=None, softDeletionThreshold=None, stepSize=abaqusConstants.MEDIUM, stiffnessMassDamping=abaqusConstants.AVERAGE_EDGE_LENGTH, stopCriteriaDesignCycle=4, structuralMassDamping=None, viscousMassDamping=None, viscousStiffnessDamping=None)[source]#

This method creates a TopologyTask object.

Note

This function can be accessed by:

mdb.models[name].TopologyTask

Note

Check TopologyTask on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the optimization task repository key.

  • abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –

    A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

    New in version 2019: The abaqusSensitivities argument was added.

  • algorithm (SymbolicConstant, default: GENERAL_OPTIMIZATION) – A SymbolicConstant specifying the optimization task algorithm. Possible values are GENERAL_OPTIMIZATION and CONDITION_BASED_OPTIMIZATION. The default value is GENERAL_OPTIMIZATION.

  • densityMoveLimit (float, default: 0) – A Float specifying the maximum density change per design cycle. The default value is 0.25.

  • densityUpdateStrategy (SymbolicConstant, default: NORMAL) – A SymbolicConstant specifying the strategy for how the densities are updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

  • elementDensityDeltaStopCriteria (float, default: 0) – A Float specifying the stop criteria based upon the change in element densities. The default value is 0.5×10-2.

  • filterRadius (Optional[float], default: None) – None or a Float specifying the mesh filter radius for mesh independence and minimum size. The default value is None.

  • firstCycleDeletedVolume (float, default: 5) – A Float specifying the volume that can be removed immediately in the first design cycle. The default value is 5.0.

  • firstCycleDeletedVolumeTechnique (SymbolicConstant, default: OFF) – A SymbolicConstant specifying the method of quantifying volume that can be removed immediately in the first design cycle. Possible values are OFF, PERCENTAGE, and ABSOLUTE. The default value is OFF.

  • freezeBoundaryConditionRegions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

  • freezeLoadRegions (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.

  • frequencySpectrumWeight (float, default: 6) – A Float specifying the weighting factor for frequency spectrum peaks. The default value is 6.0.

  • initialDensity (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the Optimization product default or a float specifying the initial density. The default value is DEFAULT.

  • materialInterpolationPenalty (float, default: 3) – A Float specifying the penalty factor for the material interpolation technique. The default value is 3.0.

  • materialInterpolationTechnique (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the material interpolation technique: optimization product default, solid isotropic material with penalization, or rational approximation of material properties. Possible values are DEFAULT, SIMP, and RAMP. The default value is DEFAULT.

  • maxDensity (float, default: 1) – A Float specifying the maximum density in the density update. The default value is 1.0.

  • minDensity (Optional[float], default: None) – A Float specifying the minimum density in the density update. The default value is 10-3.

  • modeTrackingRegion (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

  • numDesignCycles (int, default: 15) – An Int specifying the number of design cycles permitted when stepSize is DYNAMIC. The default value is 15.

  • numFulfilledStopCriteria (int, default: 2) – An Int specifying the number of stop criteria. The default value is 2.

  • numTrackedModes (int, default: 5) – An Int specifying the number of modes included in mode tracking. The default value is 5.

  • objectiveFunctionDeltaStopCriteria (Optional[float], default: None) – A Float specifying the stop criteria based on the change in objective function. The default value is 10-3.

  • region (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.

  • softDeletionMethod (SymbolicConstant, default: STANDARD) – A SymbolicConstant specifying the method used when softDeletionRegion is specified. The STANDARD method avoids creating disconnected regions. The AGGRESSIVE method only considers the softDeletionThreshold. The MAX_SHEAR_STRAIN, MAX_ELASTOPLASTIC_STRAIN and VOLUME_COMPRESSION methods do not need the softDeletionRadius. Possible values are STANDARD, AGGRESSIVE, MAX_SHEAR_STRAIN, MIN_PRINCIPAL_STRAIN, MAX_ELASTOPLASTIC_STRAIN and VOLUME_COMPRESSION. The default value is STANDARD.

  • softDeletionRadius (float, default: 0) – A Float specifying the radius to use when considering neighboring soft elements to delete. The default value is 0.0.

  • softDeletionRegion (Optional[str], default: None) – None or a Region object specifying the region in which the soft elements should be deleted during optimization. The default value is None.

  • softDeletionThreshold (Optional[float], default: None) – A Float specifying the relative material density value used to identify soft elements. Those with values below the threshold are considered for removal. For STANDARD and AGGRESSIVE methods positive values are accepted and the default value is 0.05. For MAX_SHEAR_STRAIN and MAX_ELASTOPLASTIC_STRAIN methods positive values are accepted whereas for MIN_PRINCIPAL_STRAIN and VOLUME_COMPRESSION methods negative values are accepted.

  • stepSize (SymbolicConstant, default: MEDIUM) – A SymbolicConstant specifying the size of the increment for volume modification. Possible values are DYNAMIC, VERY_SMALL, SMALL, MODERATE, MEDIUM, and LARGE. The default value is MEDIUM.

  • stiffnessMassDamping (Union[SymbolicConstant, float], default: AVERAGE_EDGE_LENGTH) – The SymbolicConstant AVERAGE_EDGE_LENGTH or a Float specifying the stiffness mass damping for the task region. The default value is AVERAGE_EDGE_LENGTH.

  • stopCriteriaDesignCycle (int, default: 4) – An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.

  • structuralMassDamping (Optional[float], default: None) – None or a Float specifying the structural mass damping for the task region. The default value is None.

  • viscousMassDamping (Optional[float], default: None) – None or a Float specifying the viscous mass damping for the task region. The default value is None.

  • viscousStiffnessDamping (Optional[float], default: None) – None or a Float specifying the viscous stiffness damping for the task region. The default value is None.

Returns:

A TopologyTask object.

Return type:

TopologyTask

TrapezoidalProfile(name, a, b, c, d)[source]#

This method creates a TrapezoidalProfile object.

Note

This function can be accessed by:

mdb.models[name].TrapezoidalProfile
session.odbs[name].TrapezoidalProfile

Note

Check TrapezoidalProfile on help.3ds.com/2021.

Parameters:
Returns:

A TrapezoidalProfile object.

Return type:

TrapezoidalProfile

Raises:

RangeError –

TrussSection(name, material, area=1)[source]#

This method creates a TrussSection object.

Note

This function can be accessed by:

mdb.models[name].TrussSection
session.odbs[name].TrussSection

Note

Check TrussSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • material (str) – A String specifying the name of the material.

  • area (float, default: 1) – A Float specifying the cross-sectional area for the section. Possible values are area >> 0. The default value is 1.0.

Returns:

A TrussSection object.

Return type:

TrussSection

Raises:

RangeError –

Velocity(name, region, velocity1, velocity2, velocity3, omega, axisBegin, axisEnd, field='', distributionType=abaqusConstants.MAGNITUDE)[source]#

This method creates a Velocity predefined field object.

Note

This function can be accessed by:

mdb.models[name].Velocity

Note

Check Velocity on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • region (Region) – A Region object specifying the region to which the predefined field is applied.

  • velocity1 (float) – A Float specifying the first component of the velocity.

  • velocity2 (float) – A Float specifying the second component of the velocity.

  • velocity3 (float) – A Float specifying the third component of the velocity.

  • omega (float) – A Float specifying the angular velocity.

  • axisBegin (tuple) – A sequence of Floats specifying the X-, Y-, and Z- coordinates of the starting point of the axis about which omega is defined.

  • axisEnd (tuple) – A sequence of Floats specifying the X-, Y-, and Z- coordinates of the end point of the axis about which omega is defined.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this predefined field. The field argument applies only when distributionType = FIELD_ANALYTICAL. The default value is an empty string.

  • distributionType (SymbolicConstant, default: MAGNITUDE) – A SymbolicConstant specifying whether the load is uniform. Possible values are MAGNITUDE and FIELD_ANALYTICAL. The default value is MAGNITUDE.

Returns:

A Velocity object.

Return type:

Velocity

VelocityAdaptiveMeshConstraint(name, createStepName, region, v1=abaqusConstants.UNSET, v2=abaqusConstants.UNSET, v3=abaqusConstants.UNSET, vr1=abaqusConstants.UNSET, vr2=abaqusConstants.UNSET, vr3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, localCsys=None, motionType=abaqusConstants.INDEPENDENT)[source]#

This method creates a VelocityAdaptiveMeshConstraint object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

Check VelocityAdaptiveMeshConstraint on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the adaptive mesh constraint repository key.

  • createStepName (str) – A String specifying the name of the step in which the adaptive mesh constraint is created.

  • region (Region) – A Region object specifying the region to which the adaptive mesh constraint is applied.

  • v1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.Note:Although v1, v2, v3, vr1, vr2, and vr3 are optional arguments, at least one of them must be specified.

  • v2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • v3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the adaptive mesh constraint has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

  • motionType (SymbolicConstant, default: INDEPENDENT) – A SymbolicConstant specifying the mesh motion in relation to the underlying material. Possible values are INDEPENDENT, FOLLOW and USER_DEFINED. The default value is INDEPENDENT.

Returns:

A VelocityAdaptiveMeshConstraint object

Return type:

VelocityAdaptiveMeshConstraint

VelocityBC(name, createStepName, region, fieldName='', v1=abaqusConstants.UNSET, v2=abaqusConstants.UNSET, v3=abaqusConstants.UNSET, vr1=abaqusConstants.UNSET, vr2=abaqusConstants.UNSET, vr3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, localCsys=None, distributionType=abaqusConstants.UNIFORM)[source]#

This method creates a VelocityBC object.

Note

This function can be accessed by:

mdb.models[name].VelocityBC

Note

Check VelocityBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • v1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.Note:Although v1, v2, v3, vr1, vr2, and vr3 are optional arguments, at least one of them must be specified.

  • v2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • v3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

Returns:

bc – A VelocityBC object.

Return type:

VelocityBC

VelocityBaseMotionBC(name, createStepName, dof, amplitudeScaleFactor=1, centerOfRotation=(), correlation=None, secondaryBase='', useComplex=OFF, amplitude=abaqusConstants.UNSET)[source]#

This method creates a VelocityBaseMotionBC object.

Note

This function can be accessed by:

mdb.models[name].VelocityBaseMotionBC

Note

Check VelocityBaseMotionBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • dof (SymbolicConstant) – A SymbolicConstant specifying the constrained degree-of-freedom. Possible values for the SymbolicConstant are U1, U2, U3, UR1, UR2, UR3. The default value is U1.

  • amplitudeScaleFactor (float, default: 1) – A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

  • centerOfRotation (tuple, default: ()) – A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

  • correlation (Optional[Correlation], default: None) – A Correlation object.

  • secondaryBase (str, default: '') – A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

  • useComplex (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

bc – A VelocityBaseMotionBC object.

Return type:

VelocityBaseMotionBC

ViscoStep(name, previous, description='', timePeriod=1, nlgeom=OFF, stabilizationMethod=abaqusConstants.NONE, stabilizationMagnitude=None, timeIncrementationMethod=abaqusConstants.AUTOMATIC, matrixSolver=abaqusConstants.DIRECT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, initialInc=None, maxNumInc=100, minInc=None, maxInc=1, integration=abaqusConstants.IMPLICIT_EXPLICIT, cetol=0, amplitude=abaqusConstants.STEP, extrapolation=abaqusConstants.LINEAR, maintainAttributes=False, solutionTechnique=abaqusConstants.FULL_NEWTON, reformKernel=8, convertSDI=abaqusConstants.PROPAGATED, adaptiveDampingRatio=0, continueDampingFactors=OFF)[source]#

This method creates a ViscoStep object.

Note

This function can be accessed by:

mdb.models[name].ViscoStep

Note

Check ViscoStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • timePeriod (float, default: 1) – A Float specifying the total time period. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.

  • stabilizationMethod (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

  • stabilizationMagnitude (Optional[float], default: None) – A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10-4.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • matrixSolver (SymbolicConstant, default: DIRECT) – A SymbolicConstant specifying the type of solver. Possible values are DIRECT and ITERATIVE. The default value is DIRECT.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.

  • maxInc (float, default: 1) – A Float specifying the maximum time increment allowed. The default is the total time period for the step. The default value is 1.0.

  • integration (SymbolicConstant, default: IMPLICIT_EXPLICIT) – A SymbolicConstant specifying which type of integration to use throughout the step. Possible values are IMPLICIT_EXPLICIT and EXPLICIT_ONLY. The default value is IMPLICIT_EXPLICIT.

  • cetol (float, default: 0) – A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the technique used to for solving nonlinear equations. Possible values are FULL_NEWTON and QUASI_NEWTON. The default value is FULL_NEWTON.

  • reformKernel (int, default: 8) – An Int specifying the number of quasi-Newton iterations allowed before the kernel matrix is reformed.. The default value is 8.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

  • adaptiveDampingRatio (float, default: 0) – A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

  • continueDampingFactors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step – A ViscoStep object.

Return type:

ViscoStep

XFEMCrackGrowth(name, createStepName, crackName, allowGrowth=ON)[source]#

This method creates an XFEMCrackGrowth object.

Note

This function can be accessed by:

mdb.models[name].XFEMCrackGrowth

Note

Check XFEMCrackGrowth on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the XFEMCrackGrowth object is created.

  • crackName (str) – A String specifying the XFEMCrack object associated with this interaction.

  • allowGrowth (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the crack is allowed to grow (propagate) during this analysis step. The default value is ON.

Returns:

A XFEMCrackGrowth object.

Return type:

XFEMCrackGrowth

XasymmBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]#

This method creates a TypeBC object that specifies antisymmetry about the X-axis.

Note

This function can be accessed by:

mdb.models[name].EncastreBC

Note

Check XasymmBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

XsymmBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]#

This method creates a TypeBC object that specifies symmetry about the X-axis.

Note

This function can be accessed by:

mdb.models[name].EncastreBC

Note

Check XsymmBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

YasymmBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]#

This method creates a TypeBC object that specifies antisymmetry about the Y-axis.

Note

This function can be accessed by:

mdb.models[name].YasymmBC

Note

Check YasymmBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

YsymmBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]#

This method creates a TypeBC object that specifies symmetry about the Y-axis.

Note

This function can be accessed by:

mdb.models[name].YsymmBC

Note

Check YsymmBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

ZasymmBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]#

This method creates a TypeBC object that specifies antisymmetry about the Z-axis.

Note

This function can be accessed by:

mdb.models[name].ZasymmBC

Note

Check ZasymmBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

ZsymmBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]#

This method creates a TypeBC object that specifies symmetry about the Z-axis.

Note

This function can be accessed by:

mdb.models[name].EncastreBC

Note

Check ZsymmBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

absoluteZero: Optional[float] = None[source]#

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]#

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]#

A repository of AdaptiveMeshControl objects.

adaptiveRemesh(odb)[source]#

This method remeshes the model using the active remesh rules in the model and the error indicator results from a previous analysis.

Note

Check Model.adaptiveRemesh on help.3ds.com/2021.

Parameters:

odb (Odb) – An Odb object containing error output field results.

Returns:

An AdaptivityIteration object.

Return type:

AdaptivityIteration

amplitudes: Dict[str, Amplitude] = {}[source]#

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]#

A repository of AnalyticalField objects.

beamProfilesFromOdb(fileName)[source]#

This method creates Profile objects by reading an output database. The new profiles are placed in the profiles repository.

Note

This function can be accessed by:

mdb.models[name].beamProfilesFromOdb

Note

Check Model.beamProfilesFromOdb on help.3ds.com/2021.

Parameters:

fileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read. The String can also be the full path to the output database file if it is located in another directory.

Returns:

A list of Profile objects.

Return type:

List[Profile]

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]#

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]#

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]#

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]#

A repository of ContactControl objects.

contactDetection(name='', createStepName='', searchDomain=abaqusConstants.MODEL, defaultType=abaqusConstants.CONTACT, interactionProperty='', separationTolerance=None, extendByAngle=20, mergeWithinAngle=20, searchSingleInstances=OFF, nameEachSurfaceFound=ON, createUnionOfMasterSurfaces=OFF, createUnionOfSlaveSurfaces=OFF, createUnionOfMasterSlaveSurfaces=OFF, includePlanar=ON, includeCylindricalSphericalToric=ON, includeSplineBased=ON, includeMeshSolid=ON, includeMeshShell=ON, includeMeshMembrane=OFF, includeOverclosed=ON, includeNonOverlapping=OFF, meshedGeometrySearchTechnique=abaqusConstants.USE_GEOMETRY, useShellThickness=ON, surfaceSmoothing=None)[source]#

This method uses contact detection to create SurfaceToSurfaceContactStd, SurfaceToSurfaceContactExp, and Tie objects.

Note

Check Model.contactDetection on help.3ds.com/2021.

Parameters:

  • name (str, default: '') – A String specifying the prefix used to generate repository keys. The default value is “CP-”

  • createStepName (str, default: '') – A String specifying the name of the step in which the SurfaceToSurfaceContactStd, SurfaceToSurfaceContactExp, and Tie objects are created. The default value is “Initial.”

  • searchDomain (SymbolicConstant, default: MODEL) – A SymbolicConstant MODEL or a sequence of Strings specifying the names of instances to search. MODEL indicates the whole model is searched. The default value is MODEL.

  • defaultType (SymbolicConstant, default: CONTACT) – A SymbolicConstant specifying the default type of object to create. Possible values are CONTACT, CONTACT_STANDARD, CONTACT_EXPLICIT, and TIE. If CONTACT is used, the behavior is determined by the type of Step in the model. If an ExplicitDynamicsStep or TempDisplacementDynamicsStep exists, then SurfaceToSurfaceContactExp is created by default. Otherwise SurfaceToSurfaceContactStd is created by default. The default value is CONTACT.

  • interactionProperty (str, default: '') – A String specifying the name of the ContactProperty object associated with any interactions created.

  • separationTolerance (Optional[float], default: None) – A Float specifying the maximum separation for considering two surfaces to be candidates for contact, where separation is the maximum distance between the points of closest approach on the two surfaces. The default value is a function of the model.

  • extendByAngle (float, default: 20) – None or a Float specifying the angle for extending surface definitions to include adjacent faces. The default value is 20.

  • mergeWithinAngle (float, default: 20) – None or a Float specifying the angle for merging adjacent contact pairs that lie within the angle. The default value is 20.

  • searchSingleInstances (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include surface pairs within a single instance. The default value is OFF.

  • nameEachSurfaceFound (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to assign a name to each surface found. The default value is ON.

  • createUnionOfMasterSurfaces (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to create a surface that is the union of all master surfaces found. The default value is OFF.

  • createUnionOfSlaveSurfaces (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to create a surface that is the union of all slave surfaces found. The default value is OFF.

  • createUnionOfMasterSlaveSurfaces (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to create a surface that is the union of all master and slave surfaces found. The default value is OFF.

  • includePlanar (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include planar geometry. The default value is ON.

  • includeCylindricalSphericalToric (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include cylindrical, spherical, and toric geometry. The default value is ON.

  • includeSplineBased (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include spline-based geometry. The default value is ON.

  • includeMeshSolid (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include solid mesh entities. The default value is ON.

  • includeMeshShell (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include shell mesh entities. The default value is ON.

  • includeMeshMembrane (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include mesh membrane entities. The default value is OFF.

  • includeOverclosed (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include overclosed pairs. The default value is ON.

  • includeNonOverlapping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include opposing geometry surfaces that do not overlap. The default value is OFF.

  • meshedGeometrySearchTechnique (SymbolicConstant, default: USE_GEOMETRY) – A SymbolicConstant USE_GEOMETRY or USE_MESH specifying whether to locate pairs in meshed geometry using the geometric entities or mesh entities. The default value is USE_GEOMETRY.

  • useShellThickness (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to account for shell thickness and offset during contact detection. The default value is ON.

  • surfaceSmoothing (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying whether to use surface smoothing for geometric surfaces in SurfaceToSurfaceContactStd interactions. Possible values are NONE and AUTOMATIC. The default value isAUTOMATIC.

Return type:

None.

contactInitializations: Dict[str, ContactInitialization] = {}[source]#

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]#

A repository of ContactStabilization objects.

convertAllSketches(regenerate=True, convertReversedSketches=True)[source]#

This method converts all sketches from Abaqus 6.5 or earlier to the equivalent ConstrainedSketch objects.

Note

Check Model.convertAllSketches on help.3ds.com/2021.

Parameters:

  • regenerate (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying if all the features in assembly as well as in all the parts in the model should be regenerated after the conversion. The default value is True.

  • convertReversedSketches (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether sketches in analytic rigid parts should be converted even if they cause the orientation of surfaces defined on them to be flipped. The default value is True.

Returns:

A list of strings describing any warnings or errors encountered during the conversion process.

Return type:

List[str]

copyConnectors: Boolean = OFF[source]#

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]#

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]#

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]#

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]#

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]#

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]#

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]#

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]#

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]#

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]#

A repository of Filter objects.

getSurfaceSeparation()[source]#

This method returns a list of all possible contacts that can be created using the ContactDetection method.

Returns:

Tuple of tuples, where each tuple holds information, to be used in contact creation as follows:

  • A string specifying the name of the master surface used in contact.

  • A string specifying the name of the slave surface used in contact.

  • A float specifying the separation distance between the master surface and the slave surface.

  • A boolean specifying whether or not contact surfaces are overclosed.

Return type:

Tuple[Tuple[str, str, float, bool], ]

globalJob: str = ''[source]#

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]#

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]#

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]#

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]#

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]#

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]#

A Float specifying the time stamp that indicates when the model was last changed.

linkInstances(instancesMap)[source]#

This method links the selected PartInstance objects to the corresponding PartInstance objects from the specified models. If all instances of a Part are selected for linking, the Part will be linked as well. If not, a new linked child Part object will be created and added to the repository.

Note

Check Model.linkInstances on help.3ds.com/2021.

Parameters:

instancesMap (tuple) – A tuple of tuples containing the instance name to be linked and the corresponding PartInstance object to which it will be linked.

Returns:

A list of strings describing any warnings or errors encountered during the conversion process.

Return type:

List[str]

linkedInstances: tuple = ()[source]#

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]#

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]#

A repository of Load objects.

materials: Dict[str, Material] = {}[source]#

A repository of Material objects.

name: str = ''[source]#

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]#

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]#

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]#

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]#

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]#

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]#

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]#

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]#

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]#

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]#

An Assembly object.

sections: Dict[str, Section] = {}[source]#

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]#

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]#

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]#

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]#

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]#

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]#

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]#

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]#

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]#

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

ModelBase#

class ModelBase(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]#

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

The corresponding analysis keywords are:

  • PHYSICAL CONSTANTS

Note

Check ModelBase on help.3ds.com/2021.

Public Data Attributes:

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
ModelFromInputFile(name, inputFileName)[source]#

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]#

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]#

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

absoluteZero: Optional[float] = None[source]#

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]#

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]#

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]#

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]#

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]#

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]#

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]#

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]#

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]#

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]#

A repository of ContactStabilization objects.

copyConnectors: Union[AbaqusBoolean, bool] = OFF[source]#

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Union[AbaqusBoolean, bool] = OFF[source]#

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Union[AbaqusBoolean, bool] = OFF[source]#

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]#

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]#

A repository of DiscreteField objects.

endRestartStep: Union[AbaqusBoolean, bool] = OFF[source]#

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]#

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]#

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]#

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]#

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]#

A repository of Filter objects.

globalJob: str = ''[source]#

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]#

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]#

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]#

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]#

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]#

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]#

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]#

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]#

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]#

A repository of Load objects.

materials: Dict[str, Material] = {}[source]#

A repository of Material objects.

name: str = ''[source]#

A String specifying the repository key.

noPartsInputFile: Union[AbaqusBoolean, bool] = OFF[source]#

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]#

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]#

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]#

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]#

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]#

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]#

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]#

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]#

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]#

An Assembly object.

sections: Dict[str, Section] = {}[source]#

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]#

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Union[AbaqusBoolean, bool] = OFF[source]#

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]#

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]#

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]#

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]#

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]#

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]#

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]#

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

AdaptivityModel#

class AdaptivityModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check AdaptivityModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

adaptiveRemesh(odb)

This method remeshes the model using the active remesh rules in the model and the error indicator results from a previous analysis.

AdaptiveMeshConstraint(name, category, region)

The AdaptiveMeshConstraint object is the abstract base type for other Arbitrary Lagrangian Eularian (ALE) style AdaptiveMeshConstraint objects.

AdaptiveMeshControl(name[, remapping, ...])

This method creates an AdaptiveMeshControl object.

DisplacementAdaptiveMeshConstraint(name, ...)

This method creates a DisplacementAdaptiveMeshConstraint object.

RemeshingRule(name, stepName, variables[, ...])

This method creates a RemeshingRule object.

VelocityAdaptiveMeshConstraint(name, ...[, ...])

This method creates a VelocityAdaptiveMeshConstraint object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
AdaptiveMeshConstraint(name, category, region, localCsys=None)[source]

The AdaptiveMeshConstraint object is the abstract base type for other Arbitrary Lagrangian Eularian (ALE) style AdaptiveMeshConstraint objects. The AdaptiveMeshConstraint object has no explicit constructor. The methods and members of the AdaptiveMeshConstraint object are common to all objects derived from the AdaptiveMeshConstraint object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

Check AdaptiveMeshConstraint on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the adaptive mesh constraint repository key.

  • category (SymbolicConstant) – A SymbolicConstant specifying the category of the adaptive mesh constraint. Possible values are MECHANICAL and THERMAL.

  • region (Region) – A Region object specifying the region to which the adaptive mesh constraint is applied.

  • localCsys (Optional[DatumCsys], default: None) – None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

An AdaptiveMeshConstraint object

Return type:

AdaptiveMeshConstraint

AdaptiveMeshControl(name, remapping=abaqusConstants.SECOND_ORDER_ADVECTION, smoothingAlgorithm=abaqusConstants.GEOMETRY_ENHANCED, smoothingPriority=abaqusConstants.UNIFORM, initialFeatureAngle=30, transitionFeatureAngle=30, momentumAdvection=abaqusConstants.ELEMENT_CENTER_PROJECTION, meshingPredictor=abaqusConstants.CURRENT, curvatureRefinement=1, volumetricSmoothingWeight=1, laplacianSmoothingWeight=0, equipotentialSmoothingWeight=0, meshConstraintAngle=60, originalConfigurationProjectionWeight=1, standardVolumetricSmoothingWeight=0)[source]

This method creates an AdaptiveMeshControl object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

Check AdaptiveMeshControl on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the name of the object.

  • remapping (SymbolicConstant, default: SECOND_ORDER_ADVECTION) – A SymbolicConstant specifying the remapping algorithm. Possible values are FIRST_ORDER_ADVECTION and SECOND_ORDER_ADVECTION. The default value is SECOND_ORDER_ADVECTION.

  • smoothingAlgorithm (SymbolicConstant, default: GEOMETRY_ENHANCED) – A SymbolicConstant specifying the type of smoothing algorithm to use. Possible values are STANDARD and GEOMETRY_ENHANCED. The default value is GEOMETRY_ENHANCED.

  • smoothingPriority (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying the type of smoothing to perform. Possible values are UNIFORM and GRADED. The default value is UNIFORM.

  • initialFeatureAngle (float, default: 30) – A Float specifying the initial geometric feature angle, θI, in degrees. Possible values are 0° ≤θI≤ 180°. The default value is 30.0.

  • transitionFeatureAngle (float, default: 30) – A Float specifying the transitional feature angle, θT, in degrees. Possible values are 0° ≤θT≤ 180°. The default value is 30.0.

  • momentumAdvection (SymbolicConstant, default: ELEMENT_CENTER_PROJECTION) – A SymbolicConstant specifying the type of momentum advection algorithm. Possible values are ELEMENT_CENTER_PROJECTION and HALF_INDEX_SHIFT. The default value is ELEMENT_CENTER_PROJECTION.

  • meshingPredictor (SymbolicConstant, default: CURRENT) – A SymbolicConstant specifying the nodal starting location to use for remeshing. Possible values are CURRENT and PREVIOUS. The default value is CURRENT.

  • curvatureRefinement (float, default: 1) – A Float specifying the solution dependence weight, αC. Possible values are 0.0 ≤αC≤ 1.0. The default value is 1.0.

  • volumetricSmoothingWeight (float, default: 1) – A Float specifying the weight used by Abaqus/Explicit for the volumetric smoothing method. The default value is 1.0.

  • laplacianSmoothingWeight (float, default: 0) – A Float specifying the weight for the Laplacian smoothing method. The default value is 0.0.

  • equipotentialSmoothingWeight (float, default: 0) – A Float specifying the weight for the equipotential smoothing method. The default value is 0.0.

  • meshConstraintAngle (float, default: 60) – A Float specifying the initial geometric feature angle, θC. Possible values are 0° ≤θC≤ 180°. The default value is 60.0.

  • originalConfigurationProjectionWeight (float, default: 1) – A Float specifying the weight for the original configuration projection method. The default value is 1.0.

  • standardVolumetricSmoothingWeight (float, default: 0) – A Float specifying the weight used by Abaqus/Standard for the volumetric smoothing method. The default value is 0.0.

Returns:

An AdaptiveMeshControl object

Return type:

AdaptiveMeshControl

DisplacementAdaptiveMeshConstraint(name, createStepName, region, u1=abaqusConstants.UNSET, u2=abaqusConstants.UNSET, u3=abaqusConstants.UNSET, ur1=abaqusConstants.UNSET, ur2=abaqusConstants.UNSET, ur3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, motionType=abaqusConstants.INDEPENDENT, localCsys=None)[source]

This method creates a DisplacementAdaptiveMeshConstraint object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

Check DisplacementAdaptiveMeshConstraint on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the adaptive mesh constraint repository key.

  • createStepName (str) – A String specifying the name of the step in which the adaptive mesh constraint is created.

  • region (Region) – A Region object specifying the region to which the adaptive mesh constraint is applied.

  • u1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the displacement component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET. Note: Although u1, u2, u3, ur1, ur2, and ur3 are optional arguments, at least one of them must be specified.

  • u2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the displacement component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • u3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the displacement component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational displacement component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational displacement component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational displacement component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the adaptive mesh constraint has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • motionType (SymbolicConstant, default: INDEPENDENT) – A SymbolicConstant specifying the mesh motion in relation to the underlying material. Possible values are INDEPENDENT, FOLLOW and USER_DEFINED. The default value is INDEPENDENT.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A DisplacementAdaptiveMeshConstraint object

Return type:

DisplacementAdaptiveMeshConstraint

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

RemeshingRule(name, stepName, variables, description='', region=abaqusConstants.MODEL, sizingMethod=abaqusConstants.DEFAULT, errorTarget=0, maxSolutionErrorTarget=0, minSolutionErrorTarget=0, meshBias=0, minElementSize=0, maxElementSize=0, outputFrequency=abaqusConstants.LAST_INCREMENT, specifyMinSize=OFF, specifyMaxSize=ON, coarseningFactor=abaqusConstants.DEFAULT_LIMIT, refinementFactor=abaqusConstants.DEFAULT_LIMIT, elementCountLimit=None)[source]

This method creates a RemeshingRule object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

Check RemeshingRule on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the name of the object.

  • stepName (str) – A String specifying the name of the step in which resizing should occur for this rule.

  • variables (tuple) – A sequence of Strings specifying the output request variables that Abaqus will use as error indicators.

  • description (str, default: '') – A String specifying a descriptive string for this rule. The default value is an empty string.

  • region (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region in which Abaqus will remesh and generate output. The SymbolicConstant MODEL represents the entire applicable model. The default value is MODEL.

  • sizingMethod (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the method for calculating the new mesh sizes. The SymbolicConstant DEFAULT indicates that Abaqus will use the default calculation method for each individual variable. Possible values are DEFAULT, UNIFORM_ERROR, and MINIMUM_MAXIMUM. The default value is DEFAULT.

  • errorTarget (float, default: 0) – A Float specifying the target error percentage for each variable in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the errorTarget argument when sizingMethod = UNIFORM_ERROR. The default value is 0.0.

  • maxSolutionErrorTarget (float, default: 0) – A Float specifying the target error percentage at the location of the maximum solution value in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the maxSolutionErrorTarget argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

  • minSolutionErrorTarget (float, default: 0) – A Float specifying the target error percentage at the location of the minimum solution value in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the minSolutionErrorTarget argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

  • meshBias (int, default: 0) – An Int specifying an indication of how much Abaqus will bias the mesh toward the location of the maximum solution value in the region. The higher the value, the more the mesh will bias towards the location of the maximum solution value. You use the meshBias argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

  • minElementSize (float, default: 0) – A Float specifying the minimum size of any single element. The default value is 0.0.

  • maxElementSize (float, default: 0) – A Float specifying the maximum size of any single element. The default value is 0.0.

  • outputFrequency (SymbolicConstant, default: LAST_INCREMENT) – A SymbolicConstant specifying the frequency with which the error indicators are saved to the output database file (.odb). Possible values are LAST_INCREMENT and ALL_INCREMENTS. The default value is LAST_INCREMENT.

  • specifyMinSize (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying an indication of whether to use a user-supplied minimum element size or to calculate a characteristic minimum element size. The default value is OFF.

  • specifyMaxSize (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying an indication of whether to use a user-supplied maximum element size or to calculate a characteristic maximum element size. The default value is ON.

  • coarseningFactor (SymbolicConstant, default: DEFAULT_LIMIT) – A SymbolicConstant or an Int specifying an indication of the upper limit on the element growth from one remeshing iteration to the next. Possible values are DEFAULT_LIMIT and NOT_ALLOWED. The default value is DEFAULT_LIMIT.

  • refinementFactor (SymbolicConstant, default: DEFAULT_LIMIT) – A SymbolicConstant or an Int specifying an indication of the upper limit on element shrinkage from one remeshing iteration to the next. Possible values are DEFAULT_LIMIT and NOT_ALLOWED. The default value is DEFAULT_LIMIT.

  • elementCountLimit (Optional[int], default: None) – None or an Int specifying an approximate limit on the number of elements that will be created during remeshing. Use None to indicate there is not upper limit. The default value is None.

Returns:

A RemeshingRule object

Return type:

RemeshingRule

VelocityAdaptiveMeshConstraint(name, createStepName, region, v1=abaqusConstants.UNSET, v2=abaqusConstants.UNSET, v3=abaqusConstants.UNSET, vr1=abaqusConstants.UNSET, vr2=abaqusConstants.UNSET, vr3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, localCsys=None, motionType=abaqusConstants.INDEPENDENT)[source]

This method creates a VelocityAdaptiveMeshConstraint object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

Check VelocityAdaptiveMeshConstraint on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the adaptive mesh constraint repository key.

  • createStepName (str) – A String specifying the name of the step in which the adaptive mesh constraint is created.

  • region (Region) – A Region object specifying the region to which the adaptive mesh constraint is applied.

  • v1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.Note:Although v1, v2, v3, vr1, vr2, and vr3 are optional arguments, at least one of them must be specified.

  • v2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • v3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the adaptive mesh constraint has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

  • motionType (SymbolicConstant, default: INDEPENDENT) – A SymbolicConstant specifying the mesh motion in relation to the underlying material. Possible values are INDEPENDENT, FOLLOW and USER_DEFINED. The default value is INDEPENDENT.

Returns:

A VelocityAdaptiveMeshConstraint object

Return type:

VelocityAdaptiveMeshConstraint

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

adaptiveRemesh(odb)[source]

This method remeshes the model using the active remesh rules in the model and the error indicator results from a previous analysis.

Note

Check Model.adaptiveRemesh on help.3ds.com/2021.

Parameters:

odb (Odb) – An Odb object containing error output field results.

Returns:

An AdaptivityIteration object.

Return type:

AdaptivityIteration

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

AmplitudeModel#

class AmplitudeModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check AmplitudeModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

ActuatorAmplitude(name[, timeSpan])

This method creates a ActuatorAmplitude object.

DecayAmplitude(name, initial, maximum, ...)

This method creates a DecayAmplitude object.

EquallySpacedAmplitude(name, fixedInterval, data)

This method creates an EquallySpacedAmplitude object.

ModulatedAmplitude(name, initial, magnitude, ...)

This method creates a ModulatedAmplitude object.

PeriodicAmplitude(name, frequency, start, ...)

This method creates a PeriodicAmplitude object.

PsdDefinition(name, data[, unitType, ...])

This method creates a PsdDefinition object.

SmoothStepAmplitude(name, data[, timeSpan])

This method creates a SmoothStepAmplitude object.

SolutionDependentAmplitude(name[, initial, ...])

This method creates a SolutionDependentAmplitude object.

SpectrumAmplitude(name, method, data[, ...])

This method creates a SpectrumAmplitude object.

TabularAmplitude(name, data[, smooth, timeSpan])

This method creates a TabularAmplitude object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
ActuatorAmplitude(name, timeSpan=abaqusConstants.STEP)[source]

This method creates a ActuatorAmplitude object.

Note

This function can be accessed by:

mdb.models[name].ActuatorAmplitude
session.odbs[name].ActuatorAmplitude

Note

Check ActuatorAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

An ActuatorAmplitude object.

Return type:

ActuatorAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

DecayAmplitude(name, initial, maximum, start, decayTime, timeSpan=abaqusConstants.STEP)[source]

This method creates a DecayAmplitude object.

Note

This function can be accessed by:

mdb.models[name].DecayAmplitude
session.odbs[name].DecayAmplitude

Note

Check DecayAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • initial (float) – A Float specifying the constant A0A0.

  • maximum (float) – A Float specifying the coefficient AA.

  • start (float) – A Float specifying the starting time t0t0. Possible values are non-negative numbers.

  • decayTime (float) – A Float specifying the decay time tdtd. Possible values are non-negative numbers.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A DecayAmplitude object.

Return type:

DecayAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

EquallySpacedAmplitude(name, fixedInterval, data, begin=0, smooth=abaqusConstants.SOLVER_DEFAULT, timeSpan=abaqusConstants.STEP)[source]

This method creates an EquallySpacedAmplitude object.

Note

This function can be accessed by:

mdb.models[name].EquallySpacedAmplitude
session.odbs[name].EquallySpacedAmplitude

Note

Check EquallySpacedAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • fixedInterval (float) – A Float specifying the fixed time interval at which the amplitude data are given. Possible values are positive numbers.

  • data (tuple) – A sequence of Floats specifying the amplitude values.

  • begin (float, default: 0) – A Float specifying the time at which the first amplitude data are given. Possible values are non-negative numbers. The default value is 0.0.

  • smooth (Union[SymbolicConstant, float], default: SOLVER_DEFAULT) – The SymbolicConstant SOLVER_DEFAULT or a Float specifying the degree of smoothing. Possible float values are 0 ≤ smoothing ≤ 0.5. If smooth = SOLVER_DEFAULT, the default degree of smoothing will be determined by the solver. The default value is SOLVER_DEFAULT.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

An EquallySpacedAmplitude object.

Return type:

EquallySpacedAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModulatedAmplitude(name, initial, magnitude, start, frequency1, frequency2, timeSpan=abaqusConstants.STEP)[source]

This method creates a ModulatedAmplitude object.

Note

This function can be accessed by:

mdb.models[name].ModulatedAmplitude
session.odbs[name].ModulatedAmplitude

Note

Check ModulatedAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • initial (float) – A Float specifying the constant A0A0.

  • magnitude (float) – A Float specifying the coefficient AA.

  • start (float) – A Float specifying the starting time t0t0. Possible values are non-negative numbers.

  • frequency1 (float) – A Float specifying the circular frequency 1 (ω1ω1). Possible values are positive numbers.

  • frequency2 (float) – A Float specifying the circular frequency 2 (ω2ω2). Possible values are positive numbers.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A ModulatedAmplitude object.

Return type:

ModulatedAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

PeriodicAmplitude(name, frequency, start, a_0, data, timeSpan=abaqusConstants.STEP)[source]

This method creates a PeriodicAmplitude object.

Note

This function can be accessed by:

mdb.models[name].PeriodicAmplitude
session.odbs[name].PeriodicAmplitude

Note

Check PeriodicAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • frequency (float) – A Float specifying the circular frequency ωω. Possible values are positive numbers.

  • start (float) – A Float specifying the starting time t0t0. Possible values are positive numbers.

  • a_0 (float) – A Float specifying the constant A0A0.

  • data (tuple) – A sequence of pairs of Floats specifying AiAi and BiBi pairs.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A PeriodicAmplitude object.

Return type:

PeriodicAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

PsdDefinition(name, data, unitType=abaqusConstants.FORCE, referenceGravityAcceleration=1, referenecePower=0, user=OFF, timeSpan=abaqusConstants.STEP, amplitude='')[source]

This method creates a PsdDefinition object.

Note

This function can be accessed by:

mdb.models[name].PsdDefinition
session.odbs[name].PsdDefinition

Note

Check PsdDefinition on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • data (tuple) – A sequence of sequences of Floats specifying the real part of the frequency function, the imaginary part of the frequency function, and the frequency or frequency band number values, depending on the value of unitType.

  • unitType (SymbolicConstant, default: FORCE) – A SymbolicConstant specifying the type of units for specifying the frequency function. FORCE implies power units. BASE implies gravity used to define base motion. DB implies decibel units. Possible values are FORCE, BASE, and DB. The default value is FORCE.

  • referenceGravityAcceleration (float, default: 1) – A Float specifying the reference gravity acceleration. This argument applies when unitType = BASE. The default value is 1.0.

  • referenecePower (float, default: 0) – A Float specifying the reference power value, in load units squared. This argument applies when unitType = DB. The default value is 0.0.

  • user (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the frequency function is defined in user subroutine UPSD. If specified, then data is not applicable, and the unitType value must not be DB. The default value is OFF.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

  • amplitude (str, default: '') – A String specifying the name of the amplitude that describes the dynamic event used to define the cross-spectral density frequency function. The default value is an empty string.

Returns:

A PsdDefinition object.

Return type:

PsdDefinition

Raises:

  • InvalidNameError –

  • RangeError –

SmoothStepAmplitude(name, data, timeSpan=abaqusConstants.STEP)[source]

This method creates a SmoothStepAmplitude object.

Note

This function can be accessed by:

mdb.models[name].SmoothStepAmplitude
session.odbs[name].SmoothStepAmplitude

Note

Check SmoothStepAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • data (tuple) – A sequence of pairs of Floats specifying time/frequency and amplitude pairs. Possible values for time/frequency are positive numbers.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A SmoothStepAmplitude object.

Return type:

SmoothStepAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

SolutionDependentAmplitude(name, initial=1, minimum=0, maximum=1000, timeSpan=abaqusConstants.STEP)[source]

This method creates a SolutionDependentAmplitude object.

Note

This function can be accessed by:

mdb.models[name].SolutionDependentAmplitude
session.odbs[name].SolutionDependentAmplitude

Note

Check SolutionDependentAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • initial (float, default: 1) – A Float specifying the initial amplitude value. Possible values are those between minimum and maximum. The default value is 1.0.

  • minimum (float, default: 0) – A Float specifying the minimum amplitude value. Possible values are those smaller than maximum and initial. The default value is 0.1.

  • maximum (float, default: 1000) – A Float specifying the maximum amplitude value. Possible values are those larger than minimum and initial. The default value is 1000.0.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A SolutionDependentAmplitude object.

Return type:

SolutionDependentAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

SpectrumAmplitude(name, method, data, specificationUnits=abaqusConstants.ACCELERATION, eventUnits=abaqusConstants.EVENT_ACCELERATION, solution=abaqusConstants.ABSOLUTE_VALUE, timeIncrement=0, gravity=1, criticalDamping=OFF, timeSpan=abaqusConstants.STEP, amplitude='')[source]

This method creates a SpectrumAmplitude object.

Note

This function can be accessed by:

mdb.models[name].SpectrumAmplitude
session.odbs[name].SpectrumAmplitude

Note

Check SpectrumAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • method (SymbolicConstant) – A SymbolicConstant specifying the method for specifying the spectrum. Possible values are DEFINE and CALCULATE.

  • data (tuple) – A sequence of sequences of Floats specifying the magnitude, frequency, and damping values.

  • specificationUnits (SymbolicConstant, default: ACCELERATION) – A SymbolicConstant specifying the units used for specifying the spectrum. Possible values are DISPLACEMENT, VELOCITY, ACCELERATION, and GRAVITY. The default value is ACCELERATION.

  • eventUnits (SymbolicConstant, default: EVENT_ACCELERATION) – A SymbolicConstant specifying the units used to describe the dynamic event in the amplitude used for the calculation. Possible values are EVENT_DISPLACEMENT, EVENT_VELOCITY, EVENT_ACCELERATION, and EVENT_GRAVITY. The default value is EVENT_ACCELERATION.

  • solution (SymbolicConstant, default: ABSOLUTE_VALUE) – A SymbolicConstant specifying the solution method for the dynamic equations. Possible values are ABSOLUTE_VALUE and RELATIVE_VALUE. The default value is ABSOLUTE_VALUE.

  • timeIncrement (float, default: 0) – A Float specifying the implicit time increment used to calculate the spectrum. This argument is required when the method = CALCULATE. The default value is 0.0.

  • gravity (float, default: 1) – A Float specifying the acceleration due to gravity. This argument applies only when specificationUnits = GRAVITY or*eventUnits* = GRAVITY. The default value is 1.0.

  • criticalDamping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to calculate the spectrum for only the specified range of critical damping values or a list of values. If criticalDamping = ON, the spectrum is calculated only for the specified range of critical damping values. If criticalDamping = OFF, the spectrum is calculated for a list of damping values. The default value is OFF.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

  • amplitude (str, default: '') – A String specifying the name of the amplitude that describes the dynamic event used to calculate the spectrum. The default value is an empty string.

Returns:

A SpectrumAmplitude object.

Return type:

SpectrumAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

TabularAmplitude(name, data, smooth=abaqusConstants.SOLVER_DEFAULT, timeSpan=abaqusConstants.STEP)[source]

This method creates a TabularAmplitude object.

Note

This function can be accessed by:

mdb.models[name].TabularAmplitude
session.odbs[name].TabularAmplitude

Note

Check TabularAmplitude on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • data (tuple) – A sequence of pairs of Floats specifying time/frequency and amplitude pairs. Possible values for time/frequency are positive numbers.

  • smooth (Union[SymbolicConstant, float], default: SOLVER_DEFAULT) – The SymbolicConstant SOLVER_DEFAULT or a Float specifying the degree of smoothing. Possible float values are between 0 and 0.5. If smooth = SOLVER_DEFAULT, the default degree of smoothing will be determined by the solver. The default value is SOLVER_DEFAULT.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A TabularAmplitude object.

Return type:

TabularAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

AssemblyModel#

class AssemblyModel[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check AssemblyModel on help.3ds.com/2021.

Public Methods:

Instance(name, objectToCopy)

This method copies a PartInstance object from the specified model and creates a new PartInstance object.

convertAllSketches([regenerate, ...])

This method converts all sketches from Abaqus 6.5 or earlier to the equivalent ConstrainedSketch objects.

linkInstances(instancesMap)

This method links the selected PartInstance objects to the corresponding PartInstance objects from the specified models.
Instance(name, objectToCopy)[source]

This method copies a PartInstance object from the specified model and creates a new PartInstance object.

Note

This function can be accessed by:

mdb.models[name].Instance

Note

Check Instance on help.3ds.com/2021.

Parameters:
Returns:

A Model object.

Return type:

Model

convertAllSketches(regenerate=True, convertReversedSketches=True)[source]

This method converts all sketches from Abaqus 6.5 or earlier to the equivalent ConstrainedSketch objects.

Note

Check Model.convertAllSketches on help.3ds.com/2021.

Parameters:

  • regenerate (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying if all the features in assembly as well as in all the parts in the model should be regenerated after the conversion. The default value is True.

  • convertReversedSketches (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether sketches in analytic rigid parts should be converted even if they cause the orientation of surfaces defined on them to be flipped. The default value is True.

Returns:

A list of strings describing any warnings or errors encountered during the conversion process.

Return type:

List[str]

linkInstances(instancesMap)[source]

This method links the selected PartInstance objects to the corresponding PartInstance objects from the specified models. If all instances of a Part are selected for linking, the Part will be linked as well. If not, a new linked child Part object will be created and added to the repository.

Note

Check Model.linkInstances on help.3ds.com/2021.

Parameters:

instancesMap (tuple) – A tuple of tuples containing the instance name to be linked and the corresponding PartInstance object to which it will be linked.

Returns:

A list of strings describing any warnings or errors encountered during the conversion process.

Return type:

List[str]

BoundaryConditionModel#

class BoundaryConditionModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check BoundaryConditionModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

AccelerationBaseMotionBC(name, ...[, ...])

This method creates a AccelerationBaseMotionBC object.

AccelerationBC(name, createStepName, region)

This method creates an AccelerationBC object.

AcousticPressureBC(name, createStepName, region)

This method creates a AcousticPressureBC object.

ConcentrationBC(name, createStepName, region)

This method creates a ConcentrationBC object.

ConnAccelerationBC(name, createStepName[, ...])

This method creates an ConnAccelerationBC object on a wire region.

ConnDisplacementBC(name, createStepName[, ...])

This method creates a ConnDisplacementBC object on a wire region.

ConnVelocityBC(name, createStepName[, ...])

This method creates a ConnVelocityBC object on a wire region.

DisplacementBaseMotionBC(name, ...[, ...])

This method creates a DisplacementBaseMotionBC object.

DisplacementBC(name, createStepName, region)

This method creates a DisplacementBC object.

ElectricPotentialBC(name, createStepName, region)

This method creates an ElectricPotentialBC object.

EulerianBC(name, createStepName, region[, ...])

This method creates a EulerianBC object.

EulerianMotionBC(name, createStepName, ...)

This method creates an EulerianMotionBC object.

FluidCavityPressureBC(name, createStepName, ...)

This method creates a FluidCavityPressureBC object.

MagneticVectorPotentialBC(name, ...[, ...])

This method creates a MagneticVectorPotentialBC object.

MaterialFlowBC(name, createStepName, region)

This method creates a MaterialFlowBC object.

PorePressureBC(name, createStepName, region)

This method creates a PorePressureBC object.

RetainedNodalDofsBC(name, createStepName, region)

This method creates a RetainedNodalDofsBC object.

SecondaryBaseBC(name, createStepName, ...)

This method creates a SecondaryBaseBC object.

SubmodelBC(name, createStepName, region, ...)

This method creates a SubmodelBC object.

TemperatureBC(name, createStepName, region)

This method creates a TemperatureBC object.

VelocityBaseMotionBC(name, createStepName, dof)

This method creates a VelocityBaseMotionBC object.

VelocityBC(name, createStepName, region[, ...])

This method creates a VelocityBC object.

EncastreBC(name, createStepName, region[, ...])

This method creates an encastre TypeBC object.

PinnedBC(name, createStepName, region[, ...])

This method creates a pinned TypeBC object.

XsymmBC(name, createStepName, region[, ...])

This method creates a TypeBC object that specifies symmetry about the X-axis.

YsymmBC(name, createStepName, region[, ...])

This method creates a TypeBC object that specifies symmetry about the Y-axis.

ZsymmBC(name, createStepName, region[, ...])

This method creates a TypeBC object that specifies symmetry about the Z-axis.

XasymmBC(name, createStepName, region[, ...])

This method creates a TypeBC object that specifies antisymmetry about the X-axis.

YasymmBC(name, createStepName, region[, ...])

This method creates a TypeBC object that specifies antisymmetry about the Y-axis.

ZasymmBC(name, createStepName, region[, ...])

This method creates a TypeBC object that specifies antisymmetry about the Z-axis.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
AccelerationBC(name, createStepName, region, fieldName='', a1=abaqusConstants.UNSET, a2=abaqusConstants.UNSET, a3=abaqusConstants.UNSET, ar1=abaqusConstants.UNSET, ar2=abaqusConstants.UNSET, ar3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, localCsys=None, distributionType=abaqusConstants.UNIFORM)[source]

This method creates an AccelerationBC object.

Note

This function can be accessed by:

mdb.models[name].AccelerationBC

Note

Check AccelerationBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • a1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the acceleration component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.Note:Although a1, a2, a3, ar1, ar2, and ar3 are optional arguments, at least one of them must be specified.

  • a2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the acceleration component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • a3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the acceleration component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ar1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational acceleration component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ar2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational acceleration component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ar3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational acceleration component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

Returns:

bc – An AccelerationBC object.

Return type:

AccelerationBC

AccelerationBaseMotionBC(name, createStepName, dof, amplitudeScaleFactor=1, centerOfRotation=(), correlation=None, secondaryBase='', useComplex=OFF, amplitude=abaqusConstants.UNSET)[source]

This method creates a AccelerationBaseMotionBC object.

Note

This function can be accessed by:

mdb.models[name].AccelerationBaseMotionBC

Note

Check AccelerationBaseMotionBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • dof (SymbolicConstant) – A SymbolicConstant specifying the constrained degree-of-freedom. Possible values for the SymbolicConstant are U1, U2, U3, UR1, UR2, UR3. The default value is U1.

  • amplitudeScaleFactor (float, default: 1) – A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

  • centerOfRotation (tuple, default: ()) – A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

  • correlation (Optional[Correlation], default: None) – A Correlation object.

  • secondaryBase (str, default: '') – A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

  • useComplex (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

bc – An AccelerationBaseMotionBC object.

Return type:

AccelerationBaseMotionBC

AcousticPressureBC(name, createStepName, region, fieldName='', magnitude=0, distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET, fixed=OFF)[source]

This method creates a AcousticPressureBC object.

Note

This function can be accessed by:

mdb.models[name].AcousticPressureBC

Note

Check AcousticPressureBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • magnitude (float, default: 0) – A Float specifying the acoustic pressure magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – An AcousticPressureBC object.

Return type:

AcousticPressureBC

ConcentrationBC(name, createStepName, region, fieldName='', magnitude=0, distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET, fixed=OFF)[source]

This method creates a ConcentrationBC object.

Note

This function can be accessed by:

mdb.models[name].ConcentrationBC

Note

Check ConcentrationBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • magnitude (float, default: 0) – A Float specifying the concentration magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A ConcentrationBC object.

Return type:

ConcentrationBC

ConnAccelerationBC(name, createStepName, region='', fastenerName='', fastenerSetName='', a1=abaqusConstants.UNSET, a2=abaqusConstants.UNSET, a3=abaqusConstants.UNSET, ar1=abaqusConstants.UNSET, ar2=abaqusConstants.UNSET, ar3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM)[source]

This method creates an ConnAccelerationBC object on a wire region. Alternatively, the boundary condition may also be applied to a wire set referenced from an assembled fastener template model.

Note

This function can be accessed by:

mdb.models[name].ConnAccelerationBC

Note

Check ConnAccelerationBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (str, default: '') – The wire region to which the boundary condition is applied. This argument is not valid when fastenerName and fastenerSetName are specified.

  • fastenerName (str, default: '') – A String specifying the name of the assembled fastener to which the boundary condition will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

  • fastenerSetName (str, default: '') – A String specifying the assembled fastener template model set to which the boundary condition will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

  • a1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the acceleration component in the connector’s local 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.Note:Although a1, a2, a3, ar1, ar2, and ar3 are optional arguments, at least one of them must be specified.

  • a2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the acceleration component in the connector’s local 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • a3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the acceleration component in the connector’s local 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ar1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational acceleration component in the connector’s local 4-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ar2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational acceleration component in the connector’s local 5-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ar3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational acceleration component in the connector’s local 6-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

Returns:

bc – A ConnAccelerationBC object.

Return type:

ConnAccelerationBC

ConnDisplacementBC(name, createStepName, region='', fastenerName='', fastenerSetName='', u1=abaqusConstants.UNSET, u2=abaqusConstants.UNSET, u3=abaqusConstants.UNSET, ur1=abaqusConstants.UNSET, ur2=abaqusConstants.UNSET, ur3=abaqusConstants.UNSET, fixed=OFF, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, buckleCase=abaqusConstants.NOT_APPLICABLE)[source]

This method creates a ConnDisplacementBC object on a wire region. Alternatively, the boundary condition may also be applied to a wire set referenced from an assembled fastener template model.

Note

This function can be accessed by:

mdb.models[name].ConnDisplacementBC

Note

Check ConnDisplacementBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (str, default: '') – The wire region to which the boundary condition is applied. This argument is not valid when fastenerName and fastenerSetName are specified.

  • fastenerName (str, default: '') – A String specifying the name of the assembled fastener to which the boundary condition will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

  • fastenerSetName (str, default: '') – A String specifying the assembled fastener template model set to which the boundary condition will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

  • u1 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.Note:Although u1, u2, u3, ur1, ur2, and ur3 are optional arguments, at least one of them must be specified.

  • u2 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • u3 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur1 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 4-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur2 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 5-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur3 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 6-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

Returns:

bc – A ConnDisplacementBC object.

Return type:

ConnDisplacementBC

ConnVelocityBC(name, createStepName, region='', fastenerName='', fastenerSetName='', v1=abaqusConstants.UNSET, v2=abaqusConstants.UNSET, v3=abaqusConstants.UNSET, vr1=abaqusConstants.UNSET, vr2=abaqusConstants.UNSET, vr3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM)[source]

This method creates a ConnVelocityBC object on a wire region. Alternatively, the boundary condition may also be applied to a wire set referenced from an assembled fastener template model.

Note

This function can be accessed by:

mdb.models[name].ConnVelocityBC

Note

Check ConnVelocityBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (str, default: '') – The wire region to which the boundary condition is applied. This argument is not valid when fastenerName and fastenerSetName are specified.

  • fastenerName (str, default: '') – A String specifying the name of the assembled fastener to which the boundary condition will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

  • fastenerSetName (str, default: '') – A String specifying the assembled fastener template model set to which the boundary condition will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

  • v1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the connector’s local 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.Note:Although v1, v2, v3, vr1, vr2, and vr3 are optional arguments, at least one of them must be specified.

  • v2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the connector’s local 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • v3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the connector’s local 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 4-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 5-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 6-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

Returns:

bc – A ConnVelocityBC object.

Return type:

ConnVelocityBC

DisplacementBC(name, createStepName, region, fieldName='', u1=abaqusConstants.UNSET, u2=abaqusConstants.UNSET, u3=abaqusConstants.UNSET, ur1=abaqusConstants.UNSET, ur2=abaqusConstants.UNSET, ur3=abaqusConstants.UNSET, fixed=OFF, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, localCsys=None, buckleCase=abaqusConstants.NOT_APPLICABLE)[source]

This method creates a DisplacementBC object.

Note

This function can be accessed by:

mdb.models[name].DisplacementBC

Note

Check DisplacementBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD or distributionType = DISCRETE_FIELD. The default value is an empty string.

  • u1 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.Note:Although u1, u2, u3, ur1, ur2, and ur3 are optional arguments, at least one of them must be specified.

  • u2 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • u3 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur1 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur2 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • ur3 (Union[SymbolicConstant, float], default: UNSET) – A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

Returns:

bc – A DisplacementBC object

Return type:

DisplacementBC

DisplacementBaseMotionBC(name, createStepName, dof, amplitudeScaleFactor=1, centerOfRotation=(), correlation=None, secondaryBase='', useComplex=OFF, amplitude=abaqusConstants.UNSET)[source]

This method creates a DisplacementBaseMotionBC object.

Note

This function can be accessed by:

mdb.models[name].DisplacementBaseMotionBC

Note

Check DisplacementBaseMotionBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • dof (SymbolicConstant) – A SymbolicConstant specifying the constrained degree-of-freedom. Possible values for the SymbolicConstant are U1, U2, U3, UR1, UR2, UR3. The default value is U1.

  • amplitudeScaleFactor (float, default: 1) – A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

  • centerOfRotation (tuple, default: ()) – A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

  • correlation (Optional[Correlation], default: None) – A Correlation object.

  • secondaryBase (str, default: '') – A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

  • useComplex (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

bc – A DisplacementBaseMotionBC object.

Return type:

DisplacementBaseMotionBC

ElectricPotentialBC(name, createStepName, region, fieldName='', magnitude=0, distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET, fixed=OFF)[source]

This method creates an ElectricPotentialBC object.

Note

This function can be accessed by:

mdb.models[name].ElectricPotentialBC

Note

Check ElectricPotentialBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • magnitude (float, default: 0) – A Float specifying the electrical potential magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – An ElectricPotentialBC object.

Return type:

ElectricPotentialBC

EncastreBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]

This method creates an encastre TypeBC object.

Note

This function can be accessed by:

mdb.models[name].EncastreBC

Note

Check EncastreBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

EulerianBC(name, createStepName, region, definition=abaqusConstants.INFLOW, inflowType=abaqusConstants.FREE, outflowType=abaqusConstants.ZERO_PRESSURE)[source]

This method creates a EulerianBC object.

Note

This function can be accessed by:

mdb.models[name].EulerianBC

Note

Check EulerianBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • definition (SymbolicConstant, default: INFLOW) – A SymbolicConstant specifying the flow conditions to be defined. Possible values are INFLOW, OUTFLOW, and BOTH. The default value is INFLOW.

  • inflowType (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the control of material flow into the Eulerian domain. Possible values are FREE, NONE, and VOID. The default value is FREE.

  • outflowType (SymbolicConstant, default: ZERO_PRESSURE) – A SymbolicConstant specifying the control of flow of material out of the Eulerian domain. Possible values are ZERO_PRESSURE, FREE, NON_REFLECTING, and EQUILIBRIUM. The default value is ZERO_PRESSURE.

Returns:

bc – An EulerianBC object.

Return type:

EulerianBC

EulerianMotionBC(name, createStepName, instanceName, followRegion=ON, region=None, materialName='', ctrPosition1=abaqusConstants.FREE, posPosition1=abaqusConstants.FREE, negPosition1=abaqusConstants.FREE, expansionRatio1=None, contractRatio1=0, ctrPosition2=abaqusConstants.FREE, posPosition2=abaqusConstants.FREE, negPosition2=abaqusConstants.FREE, expansionRatio2=None, contractRatio2=0, ctrPosition3=abaqusConstants.FREE, posPosition3=abaqusConstants.FREE, negPosition3=abaqusConstants.FREE, expansionRatio3=None, contractRatio3=0, allowContraction=ON, aspectLimit=10, vmaxFactor=1, volThreshold=0, bufferSize=2)[source]

This method creates an EulerianMotionBC object.

Note

This function can be accessed by:

mdb.models[name].EulerianMotionBC

Note

Check EulerianMotionBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • instanceName (str) – A String specifying the name of the Eulerian part instance.

  • followRegion (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the mesh will follow a regular surface region or an Eulerian surface. The default value is ON.

  • region (Optional[Region], default: None) – A Region object specifying the region to which the boundary condition is applied.

  • materialName (str, default: '') – A String specifying the name of the Eulerian surface to follow. This argument applies only when followRegion = False.

  • ctrPosition1 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the 1-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

  • posPosition1 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 1 direction. Possible values are FREE and FIXED. The default value is FREE.

  • negPosition1 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 1 direction. Possible values are FREE and FIXED. The default value is FREE.

  • expansionRatio1 (Optional[float], default: None) – None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 1 direction. If expansionRatio1 = None, then there is no upper limit. The default value is None.

  • contractRatio1 (float, default: 0) – A Float specifying the lower bounds on the allowable scaling of the mesh in the 1 direction. The default value is 0.0.

  • ctrPosition2 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the 2-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

  • posPosition2 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 2 direction. Possible values are FREE and FIXED. The default value is FREE.

  • negPosition2 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 2 direction. Possible values are FREE and FIXED. The default value is FREE.

  • expansionRatio2 (Optional[float], default: None) – None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 2 direction. If expansionRatio2 = None, then there is no upper limit. The default value is None.

  • contractRatio2 (float, default: 0) – A Float specifying the lower bounds on the allowable scaling of the mesh in the 2 direction. The default value is 0.0.

  • ctrPosition3 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the 3-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

  • posPosition3 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 3 direction. Possible values are FREE and FIXED. The default value is FREE.

  • negPosition3 (SymbolicConstant, default: FREE) – A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 3 direction. Possible values are FREE and FIXED. The default value is FREE.

  • expansionRatio3 (Optional[float], default: None) – None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 3 direction. If expansionRatio3 = None, then there is no upper limit. The default value is None.

  • contractRatio3 (float, default: 0) – A Float specifying the lower bounds on the allowable scaling of the mesh in the 3 direction. The default value is 0.0.

  • allowContraction (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the mesh is allowed to contract . The default value is ON.

  • aspectLimit (float, default: 10) – A Float specifying the maximum change in allowed aspect ratio (for any of the three mesh aspects, 1-2, 2-3, 3-1). The default value is 10.0.

  • vmaxFactor (float, default: 1) – A Float specifying the multiplier for the mesh nodal velocity limit. The default value is 1.01.

  • volThreshold (float, default: 0) – A Float specifying the lower bounds on the volume fraction when determining which nodes to include in the surface bounding box calculation for an Eulerian material surface. This argument applies only when followRegion = False. The default value is 0.5.

  • bufferSize (float, default: 2) – None or a Float specifying the buffer between the surface box and the Eulerian section mesh bounding box. The default value is 2.0.

Returns:

bc – An EulerianMotionBC object.

Return type:

EulerianMotionBC

FluidCavityPressureBC(name, createStepName, fluidCavity, magnitude=0, amplitude=abaqusConstants.UNSET, fixed=OFF)[source]

This method creates a FluidCavityPressureBC object.

Note

This function can be accessed by:

mdb.models[name].FluidCavityPressureBC

Note

Check FluidCavityPressureBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • fluidCavity (str) – A String specifying the name of a Fluid Cavity Interaction.

  • magnitude (float, default: 0) – A Float specifying the fluid cavity pressure magnitude. The default value is 0.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A FluidCavityPressureBC object.

Return type:

FluidCavityPressureBC

MagneticVectorPotentialBC(name, createStepName, region, component1=None, component2=abaqusConstants.UNSET, component3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, localCsys=None)[source]

This method creates a MagneticVectorPotentialBC object.

Note

This function can be accessed by:

mdb.models[name].MagneticVectorPotentialBC

Note

Check MagneticVectorPotentialBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • component1 (Optional[SymbolicConstant], default: None) – A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET

  • component2 (SymbolicConstant, default: UNSET) – A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • component3 (SymbolicConstant, default: UNSET) – A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

bc – A MagneticVectorPotentialBC object.

Return type:

MagneticVectorPotentialBC

MaterialFlowBC(name, createStepName, region, fieldName='', magnitude=0, distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET, fixed=OFF)[source]

This method creates a MaterialFlowBC object.

Note

This function can be accessed by:

mdb.models[name].MaterialFlowBC

Note

Check MaterialFlowBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • magnitude (float, default: 0) – A Float specifying the material flow magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A MaterialFlowBC object.

Return type:

MaterialFlowBC

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

PinnedBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]

This method creates a pinned TypeBC object.

Note

This function can be accessed by:

mdb.models[name].PinnedBC

Note

Check PinnedBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

PorePressureBC(name, createStepName, region, fieldName='', magnitude=0, distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET, fixed=OFF)[source]

This method creates a PorePressureBC object.

Note

This function can be accessed by:

mdb.models[name].PorePressureBC

Note

Check PorePressureBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • magnitude (float, default: 0) – A Float specifying the pore pressure magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A PorePressureBC object.

Return type:

PorePressureBC

RetainedNodalDofsBC(name, createStepName, region, u1=OFF, u2=OFF, u3=OFF, ur1=OFF, ur2=OFF, ur3=OFF)[source]

This method creates a RetainedNodalDofsBC object.

Note

This function can be accessed by:

mdb.models[name].RetainedNodalDofsBC

Note

Check RetainedNodalDofsBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • u1 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to retain the degree of freedom in the 1-direction. The default value is OFF indicating that the degree of freedom is not retained.

  • u2 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to retain the degree of freedom in the 2-direction. The default value is OFF indicating that the degree of freedom is not retained.

  • u3 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to retain the degree of freedom in the 3-direction. The default value is OFF indicating that the degree of freedom is not retained.

  • ur1 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to retain the rotational degree of freedom about the 1-direction. The default value is OFF indicating that the degree of freedom is not retained.

  • ur2 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to retain the rotational degree of freedom about the 2-direction. The default value is OFF indicating that the degree of freedom is not retained.

  • ur3 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to retain the rotational degree of freedom about the 3-direction. The default value is OFF indicating that the degree of freedom is not retained.

Returns:

bc – A RetainedNodalDofsBC object.

Return type:

RetainedNodalDofsBC

SecondaryBaseBC(name, createStepName, regions, dofs)[source]

This method creates a SecondaryBaseBC object.

Note

This function can be accessed by:

mdb.models[name].SecondaryBaseBC

Note

Check SecondaryBaseBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • regions (List[Region]) – A RegionArray object specifying the region to which the boundary condition is applied. Note that the usual region is ignored. The default value is MODEL.

  • dofs (tuple) – A sequence of sequences of Ints specifying the constrained degrees-of-freedom.

Returns:

bc – A SecondaryBaseBC object.

Return type:

SecondaryBaseBC

SubmodelBC(name, createStepName, region, dof, globalStep, timeScale, shellThickness, globalDrivingRegion='', absoluteExteriorTolerance=None, exteriorTolerance=0, localCsys=None, globalIncrement=0, centerZoneSize=None, intersectionOnly=OFF)[source]

This method creates a SubmodelBC object.

Note

This function can be accessed by:

mdb.models[name].SubmodelBC

Note

Check SubmodelBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • dof (tuple) – A sequence of Ints specifying the degrees of freedom to which the boundary condition is applied.

  • globalStep (str) – A String specifying the step in the global model from which Abaqus reads the values of the variables that will drive the submodel analysis. The String indicates the position of the step in the sequence of analysis steps. For example, globalStep = ‘1’ indicates the first step.

  • timeScale (Union[AbaqusBoolean, bool]) – A Boolean specifying whether to scale the time variable for the driven nodes’ amplitude functions to match the submodel analysis step time. The default value is OFF.

  • shellThickness (float) – A Float specifying the thickness of the shell in the global model. This argument is required for shell-to-solid submodeling and is not applicable to other submodels. The default value is 0.0.

  • globalDrivingRegion (str, default: '') – A String specifying the element set in the global model that will be searched for elements whose responses will be used to drive the submodel. An empty string indicates that the entire global model will be searched. The default value is an empty string.

  • absoluteExteriorTolerance (Optional[float], default: None) – None or a Float specifying the absolute value by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is None.

  • exteriorTolerance (float, default: 0) – None or a Float specifying the fraction of the average element size in the global model by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is 0.05.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

  • globalIncrement (int, default: 0) – An Int specifying the increment number in the global model step from which the solution will be used to specify the values of the driven variables. If globalIncrement = 0, the solution from the last increment will be used. The globalIncrement argument is applicable only for linear perturbation steps. The default value is 0.

  • centerZoneSize (Optional[float], default: None) – A Float specifying the thickness of the center zone size around the shell midsurface. The default value is None.

  • intersectionOnly (Union[AbaqusBoolean, bool], default: OFF) –

    A Boolean specifying whether to ignore driven nodes that lie outside the region of elements of the global model after accounting for the exterior search tolerance. The default value is OFF.

    New in version 2021: The intersectionOnly argument was added.

Returns:

bc – A SubmodelBC object.

Return type:

SubmodelBC

TemperatureBC(name, createStepName, region, fieldName='', magnitude=0, dof=(), amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, fixed=OFF)[source]

This method creates a TemperatureBC object.

Note

This function can be accessed by:

mdb.models[name].TemperatureBC

Note

Check TemperatureBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • magnitude (float, default: 0) – A Float specifying the temperature magnitude. The default value is 0.

  • dof (tuple, default: ()) – A sequence of Ints specifying the degrees of freedom to which the boundary condition is applied. The default value is (11,).

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • fixed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A TemperatureBC object.

Return type:

TemperatureBC

VelocityBC(name, createStepName, region, fieldName='', v1=abaqusConstants.UNSET, v2=abaqusConstants.UNSET, v3=abaqusConstants.UNSET, vr1=abaqusConstants.UNSET, vr2=abaqusConstants.UNSET, vr3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, localCsys=None, distributionType=abaqusConstants.UNIFORM)[source]

This method creates a VelocityBC object.

Note

This function can be accessed by:

mdb.models[name].VelocityBC

Note

Check VelocityBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • fieldName (str, default: '') – A String specifying the name of the AnalyticalField object associated with this boundary condition. The fieldName argument applies only when distributionType = FIELD. The default value is an empty string.

  • v1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.Note:Although v1, v2, v3, vr1, vr2, and vr3 are optional arguments, at least one of them must be specified.

  • v2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • v3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the velocity component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr1 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr2 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • vr3 (Union[SymbolicConstant, float], default: UNSET) – A Float or a SymbolicConstant specifying the rotational velocity component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

Returns:

bc – A VelocityBC object.

Return type:

VelocityBC

VelocityBaseMotionBC(name, createStepName, dof, amplitudeScaleFactor=1, centerOfRotation=(), correlation=None, secondaryBase='', useComplex=OFF, amplitude=abaqusConstants.UNSET)[source]

This method creates a VelocityBaseMotionBC object.

Note

This function can be accessed by:

mdb.models[name].VelocityBaseMotionBC

Note

Check VelocityBaseMotionBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • dof (SymbolicConstant) – A SymbolicConstant specifying the constrained degree-of-freedom. Possible values for the SymbolicConstant are U1, U2, U3, UR1, UR2, UR3. The default value is U1.

  • amplitudeScaleFactor (float, default: 1) – A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

  • centerOfRotation (tuple, default: ()) – A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

  • correlation (Optional[Correlation], default: None) – A Correlation object.

  • secondaryBase (str, default: '') – A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

  • useComplex (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

bc – A VelocityBaseMotionBC object.

Return type:

VelocityBaseMotionBC

XasymmBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]

This method creates a TypeBC object that specifies antisymmetry about the X-axis.

Note

This function can be accessed by:

mdb.models[name].EncastreBC

Note

Check XasymmBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

XsymmBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]

This method creates a TypeBC object that specifies symmetry about the X-axis.

Note

This function can be accessed by:

mdb.models[name].EncastreBC

Note

Check XsymmBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

YasymmBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]

This method creates a TypeBC object that specifies antisymmetry about the Y-axis.

Note

This function can be accessed by:

mdb.models[name].YasymmBC

Note

Check YasymmBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

YsymmBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]

This method creates a TypeBC object that specifies symmetry about the Y-axis.

Note

This function can be accessed by:

mdb.models[name].YsymmBC

Note

Check YsymmBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

ZasymmBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]

This method creates a TypeBC object that specifies antisymmetry about the Z-axis.

Note

This function can be accessed by:

mdb.models[name].ZasymmBC

Note

Check ZasymmBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

ZsymmBC(name, createStepName, region, buckleCase=abaqusConstants.NOT_APPLICABLE, localCsys=None)[source]

This method creates a TypeBC object that specifies symmetry about the Z-axis.

Note

This function can be accessed by:

mdb.models[name].EncastreBC

Note

Check ZsymmBC on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the boundary condition repository key.

  • createStepName (str) – A String specifying the name of the step in which the boundary condition is created.

  • region (Region) – A Region object specifying the region to which the boundary condition is applied.

  • buckleCase (SymbolicConstant, default: NOT_APPLICABLE) – A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

CalibrationModel#

class CalibrationModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check CalibrationModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

Calibration(name)

This method creates a Calibration object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
Calibration(name)[source]

This method creates a Calibration object.

Note

This function can be accessed by:

mdb.models[name].Calibration

Note

Check Calibration on help.3ds.com/2021.

Parameters:

name (str) – A String specifying the name of the new calibration.

Returns:

A Calibration object.

Return type:

Calibration

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

ConstraintModel#

class ConstraintModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check ConstraintModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

AdjustPoints(name, surface, controlPoints)

This method creates an AdjustPoints object.

Coupling(name, surface, controlPoint, ...[, ...])

This method creates a Coupling object.

DisplayBody(name, instance, controlPoints)

This method creates a DisplayBody object.

EmbeddedRegion(name, embeddedRegion, hostRegion)

This method creates a EmbeddedRegion object.

Equation(name, terms)

This method creates an Equation object.

MultipointConstraint(name, surface, ...[, ...])

This method creates a MultipointConstraint object.

RigidBody(name, refPointRegion[, ...])

This method creates a RigidBody object.

ShellSolidCoupling(name, shellEdge, solidFace)

This method creates a ShellSolidCoupling object.

Tie(name, master, slave[, adjust, ...])

This method creates a Tie object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
AdjustPoints(name, surface, controlPoints)[source]

This method creates an AdjustPoints object.

Note

This function can be accessed by:

mdb.models[name].AdjustPoints

Note

Check AdjustPoints on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • surface (Region) – A Region object specifying the surface to which the controlPoints are adjusted.

  • controlPoints (Region) – A Region object specifying the constraint control points.

Returns:

An AdjustPoints object.

Return type:

AdjustPoints

Coupling(name, surface, controlPoint, influenceRadius, couplingType, adjust=OFF, localCsys=None, u1=ON, u2=ON, u3=ON, ur1=ON, ur2=ON, ur3=ON, weightingMethod=abaqusConstants.UNIFORM)[source]

This method creates a Coupling object.

Note

This function can be accessed by:

mdb.models[name].Coupling

Note

Check Coupling on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • surface (Region) – A Region object specifying the surface on which the coupling nodes are located.

  • controlPoint (Region) – A Region object specifying the constraint control point.

  • influenceRadius (Union[SymbolicConstant, float]) – The SymbolicConstant WHOLE_SURFACE or a Float specifying the influence radius.

  • couplingType (SymbolicConstant) – A SymbolicConstant specifying the coupling constraint type. Possible values are KINEMATIC, DISTRIBUTING, and STRUCTURAL.

  • adjust (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying if the control point will be adjusted (moved) to the surface. The point will be adjusted in the direction normal to the specified surface. The default value is OFF.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the initial orientation of the local coordinate system for the coupling’s degrees of freedom. If localCsys = None, the coupling is defined in the global coordinate system. The default value is None.

  • u1 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying if the displacement component in the 1-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u1 argument applies only when couplingType = KINEMATIC.

  • u2 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying if the displacement component in the 2-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u2 argument applies only when couplingType = KINEMATIC.

  • u3 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying if the displacement component in the 3-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u3 argument applies only when couplingType = KINEMATIC.

  • ur1 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying if the rotational displacement component about the 1-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur1 argument applies only when couplingType = KINEMATIC.

  • ur2 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying if the rotational displacement component about the 2-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur2 argument applies only when couplingType = KINEMATIC.

  • ur3 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying if the rotational displacement component about the 3-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur3 argument applies only when couplingType = KINEMATIC.

  • weightingMethod (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying an optional weighting method used for calculating the distributing weight factors. Possible values are UNIFORM, LINEAR, QUADRATIC, and CUBIC. The default value is UNIFORM.The weightingMethod argument applies only when couplingType = DISTRIBUTING.

Returns:

A Coupling object.

Return type:

Coupling

DisplayBody(name, instance, controlPoints)[source]

This method creates a DisplayBody object.

Note

This function can be accessed by:

mdb.models[name].DisplayBody

Note

Check DisplayBody on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • instance (PartInstance) – A PartInstance object specifying the part instance that is to be used for display only.

  • controlPoints (List[ModelDot]) – A ModelDotArray object specifying the motion of the PartInstance. The control points may be ConstrainedSketchVertex, ReferencePoint, or MeshNode objects. Their motion will control the motion of the PartInstance. If this argument is set to an empty sequence, the PartInstance will remain fixed in space during the analysis. The sequence can have either one object or three objects.

Returns:

A DisplayBody object.

Return type:

DisplayBody

EmbeddedRegion(name, embeddedRegion, hostRegion, weightFactorTolerance=None, toleranceMethod=abaqusConstants.BOTH, absoluteTolerance=0, fractionalTolerance=0)[source]

This method creates a EmbeddedRegion object.

Note

This function can be accessed by:

mdb.models[name].EmbeddedRegion

Note

Check EmbeddedRegion on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • embeddedRegion (Region) – A Region object specifying the body region to be embedded.

  • hostRegion (Region) – A Region object specifying the host region. A value of None indicates that the host region is the whole model.

  • weightFactorTolerance (Optional[float], default: None) – A Float specifying a small value below which the weighting factors will be zeroed out. The default value is 10-6.

  • toleranceMethod (SymbolicConstant, default: BOTH) – A SymbolicConstant specifying the method used to determine the embedded element tolerance. Possible values are ABSOLUTE, FRACTIONAL, and BOTH. The default value is BOTH.

  • absoluteTolerance (float, default: 0) – A Float specifying the absolute value by which a node on the embedded region may lie outside the host region. If absoluteTolerance = 0.0, the fractionalTolerance value will be used. The default value is 0.0.This argument applies only when toleranceMethod = ABSOLUTE or BOTH.

  • fractionalTolerance (float, default: 0) – A Float specifying the fractional value by which a node on the embedded region may lie outside the host region. The fractional value is based on the average element size within the host region. The default value is 0.05.If both tolerance arguments are specified, the smaller value will be used.This argument applies only when toleranceMethod = FRACTIONAL or BOTH.

Returns:

An EmbeddedRegion object.

Return type:

EmbeddedRegion

Equation(name, terms)[source]

This method creates an Equation object.

Note

This function can be accessed by:

mdb.models[name].Equation

Note

Check Equation on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • terms (tuple) – A sequence of (Float, String, Int, Int) sequences specifying a coefficient, Set name, degree of freedom, and coordinate system ID. The coordinate system ID is optional.

Returns:

An Equation object.

Return type:

Equation

:raises If terms does not contain more than one entry`, Equation must have two or :class:`more terms.:

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

MultipointConstraint(name, surface, controlPoint, mpcType, csys=None, userType=0, userMode=abaqusConstants.DOF_MODE_MPC)[source]

This method creates a MultipointConstraint object.

Note

This function can be accessed by:

mdb.models[name].MultipointConstraint

Note

Check MultipointConstraint on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • surface (Region) – A Region object specifying the surface on which the MultipointConstraint nodes are located.

  • controlPoint (Region) – A Region object specifying the constraint control point.

  • mpcType (SymbolicConstant) – A SymbolicConstant specifying the MPC type of the constraint. Possible values are BEAM_MPC, ELBOW_MPC, PIN_MPC, LINK_MPC, TIE_MPC, and USER_MPC.

  • csys (Optional[str], default: None) – None or a DatumCsys object specifying the initial orientation of the local coordinate system for the MultipointConstraint’s degrees of freedom. If localCsys = None, the MultipointConstraint is defined in the global coordinate system. The default value is None.

  • userType (int, default: 0) – An Int specifying to differentiate between different constraint types in a user-defined MultipointConstraint. The default value is 0.The userType argument applies only when mpcType = USER_MPC.

  • userMode (SymbolicConstant, default: DOF_MODE_MPC) – A SymbolicConstant specifying the mode of the constraint when it is user-defined. Possible values are DOF_MODE_MPC and NODE_MODE_MPC. The default value is DOF_MODE_MPC.The userMode argument applies only when mpcType = USER_MPC.

Returns:

A MultipointConstraint object.

Return type:

MultipointConstraint

RigidBody(name, refPointRegion, bodyRegion=None, tieRegion=None, pinRegion=None, surfaceRegion=None, refPointAtCOM=OFF, isothermal=OFF)[source]

This method creates a RigidBody object.

Note

This function can be accessed by:

mdb.models[name].RigidBody

Note

Check RigidBody on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • refPointRegion (Region) – A Region object specifying the reference point.

  • bodyRegion (Optional[str], default: None) – None or a Region object specifying the elements constrained to the movement of the reference point. The default value is None.

  • tieRegion (Optional[str], default: None) – None or a Region object specifying the nodes tied to the movement of the reference point. The default value is None.

  • pinRegion (Optional[str], default: None) – None or a Region object specifying the nodes pinned to the movement of the reference point. The default value is None.

  • surfaceRegion (Optional[str], default: None) – None or a Region object specifying the analytic surface constrained to the movement of the reference point. The default value is None.

  • refPointAtCOM (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the analysis product should recompute the reference point position to be at the center of mass. The default value is OFF.

  • isothermal (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the temperature degree of freedom should be constrained. The default value is OFF.

Returns:

A RigidBody object.

Return type:

RigidBody

ShellSolidCoupling(name, shellEdge, solidFace, positionToleranceMethod=abaqusConstants.COMPUTED, positionTolerance=0, influenceDistanceMethod=abaqusConstants.DEFAULT, influenceDistance=0)[source]

This method creates a ShellSolidCoupling object.

Note

This function can be accessed by:

mdb.models[name].ShellSolidCoupling

Note

Check ShellSolidCoupling on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • shellEdge (Region) – A Region object specifying the name of the shell edge surface.

  • solidFace (Region) – A Region object specifying the name of the solid surface.

  • positionToleranceMethod (SymbolicConstant, default: COMPUTED) – A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED and SPECIFIED. The default value is COMPUTED.

  • positionTolerance (float, default: 0) – A Float specifying the position tolerance. The default value is 0.0.The positionTolerance argument applies only when positionToleranceMethod = SPECIFIED.Note:Abaqus will not constrain nodes on the solid face region outside the position tolerance.

  • influenceDistanceMethod (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the method used to determine the influence distance. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.

  • influenceDistance (float, default: 0) – A Float specifying the influence distance. The influenceDistance argument applies only when influenceDistanceMethod = SPECIFIED. The default value is 0.0.

Returns:

A ShellSolidCoupling object.

Return type:

ShellSolidCoupling

Tie(name, master, slave, adjust=ON, positionToleranceMethod=abaqusConstants.COMPUTED, positionTolerance=0, tieRotations=ON, constraintRatioMethod=abaqusConstants.DEFAULT, constraintRatio=0, constraintEnforcement=abaqusConstants.SOLVER_DEFAULT, thickness=ON)[source]

This method creates a Tie object.

Note

This function can be accessed by:

mdb.models[name].Tie

Note

Check Tie on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the constraint repository key.

  • master (Region) – A Region object specifying the name of the master surface.

  • slave (Region) – A Region object specifying the name of the slave surface.

  • adjust (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether initial positions of tied slave nodes are adjusted to lie on the master surface. The default value is ON.

  • positionToleranceMethod (SymbolicConstant, default: COMPUTED) – A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED and SPECIFIED. The default value is COMPUTED.

  • positionTolerance (float, default: 0) – A Float specifying the position tolerance. The positionTolerance argument applies only when positionToleranceMethod = SPECIFIED. The default value is 0.0.

  • tieRotations (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether rotation degrees of freedom should be tied. The default value is ON.

  • constraintRatioMethod (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the method used to determine the constraint ratio. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.

  • constraintRatio (float, default: 0) – A Float specifying the fractional distance between the master reference surface and the slave node at which the translational constraint should act. The constraintRatio argument applies only when constraintRatioMethod = SPECIFIED. The default value is 0.0.

  • constraintEnforcement (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the discretization method. Possible values are SOLVER_DEFAULT, NODE_TO_SURFACE, and SURFACE_TO_SURFACE. The default value is SOLVER_DEFAULT.

  • thickness (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether shell element thickness is considered. The default value is ON.

Returns:

A Tie object.

Return type:

Tie

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

FilterModel#

class FilterModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check FilterModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

ButterworthFilter(name, cutoffFrequency[, ...])

This method creates a ButterworthFilter object.

Chebyshev1Filter(name, cutoffFrequency[, ...])

This method creates a Chebyshev1Filter object.

Chebyshev2Filter(name, cutoffFrequency[, ...])

This method creates a Chebyshev2Filter object.

OperatorFilter(name, cutoffFrequency[, ...])

This method creates an OperatorFilter object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
ButterworthFilter(name, cutoffFrequency, order=2, operation=abaqusConstants.NONE, halt=OFF, limit=None, invariant=abaqusConstants.NONE)[source]

This method creates a ButterworthFilter object.

Note

This function can be accessed by:

mdb.models[name].ButterworthFilter
session.odbs[name].ButterworthFilter

Note

Check ButterworthFilter on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key. This name ANTIALIASING is reserved for filters generated internally by the program.

  • cutoffFrequency (float) – A Float specifying the attenuation point of the filter. Possible values are non-negative numbers. Order is not available for OperatorFilter.

  • order (int, default: 2) – An Int specifying the highest power of the filter transfer function. Possible values are non-negative numbers less than or equal to 20. Order is not available for OperatorFilter. The default value is 2.

  • operation (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the filter operator. Possible values are NONE, MIN, MAX, and ABS. The default value is NONE.

  • halt (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to stop the analysis if the specified limit is reached. The default value is OFF.

  • limit (Optional[float], default: None) – None or a Float specifying the threshold limit, an upper or lower bound for output values depending on the operation, or a bound for stopping the analysis when Halt is used. The default value is None.

  • invariant (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the invariant to which filtering is applied. Possible values are NONE, FIRST, and SECOND. The default value is NONE.

Returns:

A ButterworthFilter object.

Return type:

ButterworthFilter

Raises:

  • InvalidNameError –

  • RangeError –

Chebyshev1Filter(name, cutoffFrequency, rippleFactor=0, order=2, operation=abaqusConstants.NONE, halt=OFF, limit=None, invariant=abaqusConstants.NONE)[source]

This method creates a Chebyshev1Filter object.

Note

This function can be accessed by:

mdb.models[name].Chebyshev1Filter
session.odbs[name].Chebyshev1Filter

Note

Check Chebyshev1Filter on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key. This name ANTIALIASING is reserved for filters generated internally by the program.

  • cutoffFrequency (float) – A Float specifying the attenuation point of the filter. Possible values are non-negative numbers. Order is not available for OperatorFilter.

  • rippleFactor (float, default: 0) – A Float specifying the amount of allowable ripple in the filter. Possible values are non-negative numbers. The default value is 0.225.

  • order (int, default: 2) – An Int specifying the highest power of the filter transfer function. Possible values are non-negative numbers less than or equal to 20. Order is not available for OperatorFilter. The default value is 2.

  • operation (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the filter operator. Possible values are NONE, MIN, MAX, and ABS. The default value is NONE.

  • halt (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to stop the analysis if the specified limit is reached. The default value is OFF.

  • limit (Optional[float], default: None) – None or a Float specifying the threshold limit, an upper or lower bound for output values depending on the operation, or a bound for stopping the analysis when Halt is used. The default value is None.

  • invariant (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the invariant to which filtering is applied. Possible values are NONE, FIRST, and SECOND. The default value is NONE.

Returns:

A Chebyshev1Filter object.

Return type:

Chebyshev1Filter

Raises:

  • InvalidNameError –

  • RangeError –

Chebyshev2Filter(name, cutoffFrequency, rippleFactor=0, order=2, operation=abaqusConstants.NONE, halt=OFF, limit=None, invariant=abaqusConstants.NONE)[source]

This method creates a Chebyshev2Filter object.

Note

This function can be accessed by:

mdb.models[name].Chebyshev2Filter
session.odbs[name].Chebyshev2Filter

Note

Check Chebyshev2Filter on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key. This name ANTIALIASING is reserved for filters generated internally by the program.

  • cutoffFrequency (float) – A Float specifying the attenuation point of the filter. Possible values are non-negative numbers. Order is not available for OperatorFilter.

  • rippleFactor (float, default: 0) – A Float specifying the amount of allowable ripple in the filter. Possible values are non-negative numbers less than 1. The default value is 0.025.

  • order (int, default: 2) – An Int specifying the highest power of the filter transfer function. Possible values are non-negative numbers less than or equal to 20. Order is not available for OperatorFilter. The default value is 2.

  • operation (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the filter operator. Possible values are NONE, MIN, MAX, and ABS. The default value is NONE.

  • halt (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to stop the analysis if the specified limit is reached. The default value is OFF.

  • limit (Optional[float], default: None) – None or a Float specifying the threshold limit, an upper or lower bound for output values depending on the operation, or a bound for stopping the analysis when Halt is used. The default value is None.

  • invariant (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the invariant to which filtering is applied. Possible values are NONE, FIRST, and SECOND. The default value is NONE.

Returns:

A Chebyshev2Filter object.

Return type:

Chebyshev2Filter

Raises:

  • InvalidNameError –

  • RangeError –

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

OperatorFilter(name, cutoffFrequency, order=2, operation=abaqusConstants.NONE, halt=OFF, limit=None, invariant=abaqusConstants.NONE)[source]

This method creates an OperatorFilter object.

Note

This function can be accessed by:

mdb.models[name].OperatorFilter
session.odbs[name].OperatorFilter

Note

Check OperatorFilter on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key. This name ANTIALIASING is reserved for filters generated internally by the program.

  • cutoffFrequency (float) – A Float specifying the attenuation point of the filter. Possible values are non-negative numbers. Order is not available for OperatorFilter.

  • order (int, default: 2) – An Int specifying the highest power of the filter transfer function. Possible values are non-negative numbers less than or equal to 20. Order is not available for OperatorFilter. The default value is 2.

  • operation (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the filter operator. Possible values are NONE, MIN, MAX, and ABS. The default value is NONE.

  • halt (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to stop the analysis if the specified limit is reached. The default value is OFF.

  • limit (Optional[float], default: None) – None or a Float specifying the threshold limit, an upper or lower bound for output values depending on the operation, or a bound for stopping the analysis when Halt is used. The default value is None.

  • invariant (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the invariant to which filtering is applied. Possible values are NONE, FIRST, and SECOND. The default value is NONE.

Returns:

An OperatorFilter object.

Return type:

OperatorFilter

Raises:

  • InvalidNameError –

  • RangeError –

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

InteractionModel#

class InteractionModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check InteractionModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

contactDetection([name, createStepName, ...])

This method uses contact detection to create SurfaceToSurfaceContactStd, SurfaceToSurfaceContactExp, and Tie objects.

getSurfaceSeparation()

This method returns a list of all possible contacts that can be created using the ContactDetection method.

AcousticImpedance(name, createStepName, surface)

This method creates an AcousticImpedance object.

ActuatorSensor(name, createStepName, point, ...)

This method creates an ActuatorSensor object.

CavityRadiation(name, createStepName, surfaces)

This method creates a CavityRadiation object.

ConcentratedFilmCondition(name, ...[, ...])

This method creates a ConcentratedFilmCondition object.

ConcentratedRadiationToAmbient(name, ...[, ...])

This method creates a ConcentratedRadiationToAmbient object.

ContactExp(name, createStepName[, ...])

This method creates a ContactExp object.

ContactStd(name, createStepName[, ...])

This method creates a ContactStd object.

CyclicSymmetry(name, createStepName, master, ...)

This method creates a CyclicSymmetry object.

ElasticFoundation(name, createStepName, ...)

This method creates an ElasticFoundation object.

FilmCondition(name, createStepName, surface, ...)

This method creates a FilmCondition object.

FluidCavity(name, createStepName, ...[, ...])

This method creates an FluidCavity object.

FluidExchange(name, createStepName, ...[, ...])

This method creates an FluidExchange object.

FluidInflator(name, createStepName, cavity, ...)

This method creates a FluidInflator object.

IncidentWave(name, createStepName, ...[, ...])

This method creates an IncidentWave object.

ModelChange(name, createStepName[, ...])

This method creates a ModelChange object.

PressurePenetration(name, createStepName, ...)

This method creates a PressurePenetration object.

RadiationToAmbient(name, createStepName, ...)

This method creates a RadiationToAmbient object.

SelfContactExp(name, createStepName, ...[, ...])

This method creates a SelfContactExp object.

SelfContactStd(name, createStepName, ...[, ...])

This method creates a SelfContactStd object.

StdXplCosimulation(name, createStepName, region)

This method creates a StdXplCosimulation object.

SurfaceToSurfaceContactExp(name, ...[, ...])

This method creates a SurfaceToSurfaceContactExp object.

SurfaceToSurfaceContactStd(name, ...[, ...])

This method creates a SurfaceToSurfaceContactStd object.

XFEMCrackGrowth(name, createStepName, crackName)

This method creates an XFEMCrackGrowth object.
Inherited from InteractionContactControlModel

ExpContactControl(name[, globTrkChoice, ...])

This method creates an ExpContactControl object.

StdContactControl(name[, ...])

This method creates an StdContactControl object.
Inherited from InteractionContactInitializationModel

ExpInitialization(name[, overclosureType, ...])

This method creates an ExpInitialization object.

StdInitialization(name[, overclosureType, ...])

This method creates a StdInitialization object.
Inherited from InteractionContactStabilizationModel

StdStabilization(name[, zeroDistance, ...])

This method creates a StdStabilization object.
Inherited from InteractionPropertyModel

AcousticImpedanceProp(name, tableType, table)

This method creates an AcousticImpedanceProp object.

ActuatorSensorProp(name[, realProperties, ...])

This method creates an ActuatorSensorProp object.

CavityRadiationProp(name[, ...])

This method creates a CavityRadiationProp object.

ContactProperty(name)

This method creates a ContactProperty object.

FilmConditionProp(name[, ...])

This method creates a FilmConditionProp object.

FluidCavityProperty(name[, definition, ...])

This method creates a FluidCavityProperty object.

FluidExchangeProperty(name, dataTable[, ...])

This method creates a FluidExchangeProperty object.

FluidInflatorProperty(name, definition, ...)

This method creates a FluidInflatorProperty object.

IncidentWaveProperty(name[, definition, ...])

This method creates an IncidentWaveProperty object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
AcousticImpedance(name, createStepName, surface, definition=abaqusConstants.TABULAR, interactionProperty='', nonreflectingType=abaqusConstants.PLANE, radius=1, semimajorAxis=1, eccentricity=0, centerCoordinates=(), directionCosine=())[source]

This method creates an AcousticImpedance object.

Note

This function can be accessed by:

mdb.models[name].AcousticImpedance

Note

Check AcousticImpedance on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the AcousticImpedance object is created.

  • surface (Region) – A Region object specifying the acoustic boundary surface.

  • definition (SymbolicConstant, default: TABULAR) – A SymbolicConstant specifying the type of acoustic impedance to be defined. Possible values are TABULAR and NONREFLECTING. The default value is TABULAR.

  • interactionProperty (str, default: '') – A String specifying the AcousticImpedanceProp object associated with this interaction.

  • nonreflectingType (SymbolicConstant, default: PLANE) – A SymbolicConstant specifying the type of nonreflecting geometry to be defined. Possible values are PLANE, IMPROVED, CIRCULAR, SPHERICAL, ELLIPTICAL, and PROLATE. The default value is PLANE.This argument is valid only when definition = NONREFLECTING.

  • radius (float, default: 1) – A Float specifying the radius of the circle or sphere defining the boundary surface. The default value is 1.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = CIRCULAR or SPHERICAL.

  • semimajorAxis (float, default: 1) – A Float specifying the semimajor axis length of the ellipse or prolate spheroid defining the boundary surface. The default value is 1.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.

  • eccentricity (float, default: 0) – A Float specifying the eccentricity of the ellipse or prolate spheroid defining the boundary surface. The default value is 0.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.

  • centerCoordinates (tuple, default: ()) – A sequence of three Floats specifying the X, Y, and Z coordinates of the center of the ellipse or prolate spheroid defining the boundary surface. The default value is (0, 0, 0).This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.

  • directionCosine (tuple, default: ()) – A sequence of three Floats specifying the X, Y, and Z components of the direction cosine of the major axis of the ellipse or prolate spheroid defining the boundary surface. The default value is (0, 0, 1).This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.

Returns:

An AcousticImpedance object.

Return type:

AcousticImpedance

AcousticImpedanceProp(name, tableType, table, frequencyDependency=OFF)[source]

This method creates an AcousticImpedanceProp object.

Note

This function can be accessed by:

mdb.models[name].AcousticImpedanceProp

Note

Check AcousticImpedanceProp on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • tableType (SymbolicConstant) – A SymbolicConstant specifying the type of tabular data to be defined. Possible values are IMPEDANCE and ADMITTANCE.

  • table (tuple) – A sequence of sequences of Floats specifying acoustic impedance properties.If tableType = IMPEDANCE, each sequence of the table data specifies:The real part of the complex impedance.The imaginary part of the complex impedance.Frequency, if the data depend on frequency.If tableType = ADMITTANCE, each sequence of the table data specifies:The real part of the complex admittance.The imaginary part of the complex admittance.Frequency, if the data depend on frequency.

  • frequencyDependency (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the table data depend on frequency. The default value is OFF.

Returns:

An AcousticImpedanceProp object.

Return type:

AcousticImpedanceProp

ActuatorSensor(name, createStepName, point, interactionProperty, noCoordComponents, unsymm, noSolutionDepVar, userSubUel, dof, solutionDepVars)[source]

This method creates an ActuatorSensor object.

Note

This function can be accessed by:

mdb.models[name].ActuatorSensor

Note

Check ActuatorSensor on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the actuator/sensor interaction is created. createStepName must be set to ‘Initial’.

  • point (Region) – A Region object specifying the point at which the constraint is applied.

  • interactionProperty (str) – A String specifying the ActuatorSensorProp object associated with this interaction.

  • noCoordComponents (int) – An Int specifying the number of coordinate components supplied to the user subroutine (UEL).

  • unsymm (Union[AbaqusBoolean, bool]) – A Boolean specifying whether the element matrices are symmetric (ON) or unsymmetric (OFF). The default value is OFF.

  • noSolutionDepVar (int) – An Int specifying the number of solution-dependent variables. The default value is 0.

  • userSubUel (str) – A String specifying the name of the user subroutine (UEL) that defines the user element.

  • dof (str) – A String specifying the degrees of freedom, separated by commas.

  • solutionDepVars (tuple) – A sequence of Floats specifying the initial values of the solution-dependent variables.

Returns:

An ActuatorSensor object.

Return type:

ActuatorSensor

ActuatorSensorProp(name, realProperties=(), integerProperties=())[source]

This method creates an ActuatorSensorProp object.

Note

This function can be accessed by:

mdb.models[name].ActuatorSensorProp

Note

Check ActuatorSensorProp on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • realProperties (tuple, default: ()) – A sequence of Floats specifying the PROPS array used by user subroutine UEL. The default value is an empty sequence.

  • integerProperties (tuple, default: ()) – A sequence of Ints specifying the JPROPS array used by user subroutine UEL. The default value is an empty sequence.

Returns:

An ActuatorSensorProp object.

Return type:

ActuatorSensorProp

CavityRadiation(name, createStepName, surfaces, surfaceEmissivities=(), ambientTemp=None, blocking=abaqusConstants.BLOCKING_ALL, blockingSurfaces=None, rangeOfView=None, surfaceReflection=ON, viewfactorAccurTol=0, minInfinitesimalRatio=64, numPointsPerEdge=3, minLumpedAreaDS=5, cyclicSymmetry=OFF, cyclicImages=2, cyclicRotPt=None, cyclicRotEndPt=None, cyclicSymPt=None, periodicSymmetries=0, periodicImages_1=2, periodicImages_2=2, periodicImages_3=2, periodicSymAxis_1='', periodicSymAxis_2='', periodicSymPlane_1='', periodicSymPlane_2='', periodicSymPlane_3='', periodicDistance_1=(), periodicDistance_2=(), periodicDistance_3=(), periodicSymZ=None, periodicDistZ=None, reflectionSymmetries=0, reflectionSymAxis_1='', reflectionSymAxis_2='', reflectionSymPlane_1='', reflectionSymPlane_2='', reflectionSymPlane_3='', reflectionSymZ=None)[source]

This method creates a CavityRadiation object.

Note

This function can be accessed by:

mdb.models[name].CavityRadiation

Note

Check CavityRadiation on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the cavity radiation interaction should be created.

  • surfaces (List[Region]) – A RegionArray object specifying the surfaces for which radiation viewfactor control is being specified.

  • surfaceEmissivities (tuple, default: ()) – A sequence of Strings specifying the names of the Cavity Radiation properties containing the surface emissivity data. One name per specified surface. The emissivity data is ignored when surfaceReflection = OFF.

  • ambientTemp (Optional[float], default: None) – None or a Float specifying the reference ambient temperature value, θ0θ0. Specifying a value indicates an open cavity. The default value is None.

  • blocking (SymbolicConstant, default: BLOCKING_ALL) – A SymbolicConstant specifying the blocking checks to be performed in the viewfactor calculations. Possible values are BLOCKING_ALL, NO_BLOCKING, and PARTIAL_BLOCKING. The default value is BLOCKING_ALL.

  • blockingSurfaces (Optional[List[Region]], default: None) – A RegionArray object specifying the surfaces that provide blocking inside the cavity. This argument applies only when blocking = PARTIAL_BLOCKING.

  • rangeOfView (Optional[float], default: None) – None or a Float specifying the maximum distance between surface facets at which viewfactors are calculated. More distant facets are deemed too far apart to exchange significant amounts of heat through radiation effects, and the viewfactors between these facets are assumed to be zero. If rangeOfView = None, there is no upper limit. The default value is None.

  • surfaceReflection (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether heat reflections are to be included in the cavity radiation calculations. The default value is ON.

  • viewfactorAccurTol (float, default: 0) – A Float specifying the acceptable tolerance for the viewfactor calculations. The default value is 0.05.

  • minInfinitesimalRatio (float, default: 64) – A Float specifying the facet area ratio above which the infinitesimal-to-finite area approximation is used for viewfactor calculations. The default value is 64.0.

  • numPointsPerEdge (int, default: 3) – An Int specifying the number of Gauss integration points to be used along each edge when the numerical integration of contour integrals is used for viewfactor calculations. One to five integration points are allowed. The default value is 3.

  • minLumpedAreaDS (float, default: 5) – A Float specifying the nondimensional distance-square value above which the lumped area approximation is used for viewfactor calculations. The default value is 5.0.

  • cyclicSymmetry (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether cyclic symmetry will be applied. This argument cannot be specified for axisymmetric models. The default value is OFF.

  • cyclicImages (int, default: 2) – An Int specifying the number of cyclically similar images that compose the cavity formed as a result of this symmetry. This argument applies only when cyclicSymmetry = ON. The default value is 2.

  • cyclicRotPt (Optional[ModelDot], default: None) – A ModelDot object specifying the rotation axis point. This argument applies only when cyclicSymmetry = ON.

  • cyclicRotEndPt (Optional[ModelDot], default: None) – A ModelDot object specifying the rotation axis end point. This argument applies only for three-dimensional models, and only when cyclicSymmetry = ON.

  • cyclicSymPt (Optional[ModelDot], default: None) – A ModelDot object specifying the symmetry axis end point. This argument applies only when cyclicSymmetry = ON.

  • periodicSymmetries (int, default: 0) – An Int specifying the number of periodic symmetries that will be applied. The default value is 0.

  • periodicImages_1 (int, default: 2) – An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the first periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_1. This argument applies only when periodicSymmetries is greater than zero. The default value is 2.

  • periodicImages_2 (int, default: 2) – An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the second periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_2. This argument applies only when periodicSymmetries is greater than one. The default value is 2.

  • periodicImages_3 (int, default: 2) – An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the third periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_3. This argument applies only when periodicSymmetries = 3. The default value is 2.

  • periodicSymAxis_1 (str, default: '') – A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the first line of symmetry in two-dimensional models. This argument applies only for 2D models, and when periodicSymmetries is greater than zero.

  • periodicSymAxis_2 (str, default: '') – A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the second line of symmetry in two-dimensional models. This argument applies only for two-dimensional models, and when periodicSymmetries = 2.

  • periodicSymPlane_1 (str, default: '') – A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the first plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when periodicSymmetries is greater than zero.

  • periodicSymPlane_2 (str, default: '') – A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the second plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when periodicSymmetries is greater than one.

  • periodicSymPlane_3 (str, default: '') – A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the third plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when periodicSymmetries = 3.

  • periodicDistance_1 (tuple, default: ()) – A sequence of sequences of Floats specifying the two points of the vector that describes the periodic distance for the first periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries is greater than zero. The default value is an empty sequence.

  • periodicDistance_2 (tuple, default: ()) – A sequence of sequences of Floats specifying the two points of the vector that describes the periodic distance for the second periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries is greater than one. The default value is an empty sequence.

  • periodicDistance_3 (tuple, default: ()) – A sequence of sequences of Floats specifying the two points of the vector that describes the periodic distance for the third periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries = 3. The default value is an empty sequence.

  • periodicSymZ (Optional[float], default: None) – None or a Float specifying the Z value indicating the symmetry reference line in axisymmetric models. This argument applies only for axisymmetric models, and when periodicSymmetries = 1. The default value is None.

  • periodicDistZ (Optional[float], default: None) – None or a Float specifying the Z value indicating the periodic distance in axisymmetric models. This argument applies only for axisymmetric models, and when periodicSymmetries = 1. The default value is None.

  • reflectionSymmetries (int, default: 0) – An Int specifying the number of reflection symmetries will be applied. The default value is 0.

  • reflectionSymAxis_1 (str, default: '') – A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the first line of symmetry in two-dimensional models. This argument applies only for two-dimensional models, and when reflectionSymmetries is greater than zero.

  • reflectionSymAxis_2 (str, default: '') – A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the second line of symmetry in two-dimensional models. This argument applies only for two-dimensional models, and when reflectionSymmetries = 2.

  • reflectionSymPlane_1 (str, default: '') – A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the first plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when reflectionSymmetries is greater than zero.

  • reflectionSymPlane_2 (str, default: '') – A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the second plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when reflectionSymmetries is greater than one.

  • reflectionSymPlane_3 (str, default: '') – A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the third plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when reflectionSymmetries = 3.

  • reflectionSymZ (Optional[float], default: None) – None or a Float specifying the Z value indicating the symmetry reference line in axisymmetric models. This argument applies only for axisymmetric models, and when reflectionSymmetries = 1. The default value is None.

Returns:

A CavityRadiation object.

Return type:

CavityRadiation

CavityRadiationProp(name, temperatureDependency=OFF, dependencies=0, property=())[source]

This method creates a CavityRadiationProp object.

Note

This function can be accessed by:

mdb.models[name].CavityRadiationProp

Note

Check CavityRadiationProp on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • property (tuple, default: ()) – A sequence of sequences of Floats specifying the following:The emissivity, ϵϵ.Temperature, if the data depend on temperature.Value of the first field variable, if the data depend on field variables.Value of the second field variable.Etc.

Returns:

A CavityRadiationProp object.

Return type:

CavityRadiationProp

ConcentratedFilmCondition(name, createStepName, region, definition, nodalArea=1, explicitRegionType=abaqusConstants.LAGRANGIAN, interactionProperty='', field='', sinkTemperature=0, sinkAmplitude='', filmCoeff=0, filmCoeffAmplitude='', sinkFieldName='', sinkDistributionType=abaqusConstants.UNIFORM)[source]

This method creates a ConcentratedFilmCondition object.

Note

This function can be accessed by:

mdb.models[name].ConcentratedFilmCondition

Note

Check ConcentratedFilmCondition on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the ConcentratedFilmCondition object is created.

  • region (Region) – A Region object specifying the region to which the concentrated film condition interaction is applied. The interaction is applied to each node in the region.

  • definition (SymbolicConstant) – A SymbolicConstant specifying how the concentrated film condition is defined. Possible values are EMBEDDED_COEFF, PROPERTY_REF, USER_SUB, and FIELD.

  • nodalArea (float, default: 1) – A Float specifying the area associated with the node where the concentrated film condition is applied. The default value is 1.0.

  • explicitRegionType (SymbolicConstant, default: LAGRANGIAN) – A SymbolicConstant specifying how the concentrated film condition is applied to the boundary of an adaptive mesh domain. Possible values are LAGRANGIAN, SLIDING, and EULERIAN. The default value is LAGRANGIAN. This argument applies only during an Abaqus/Explicit analysis.

  • interactionProperty (str, default: '') – A String specifying the name of the FilmConditionProp object associated with this interaction. The interactionProperty argument applies only when definition = PROPERTY_REF. The default value is an empty string.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when definition = FIELD. The default value is an empty string.

  • sinkTemperature (float, default: 0) – A Float specifying the reference sink temperature, θ0θ0. The default value is 0.0.

  • sinkAmplitude (str, default: '') – A String specifying the name of the Amplitude object that gives the variation of the sink temperature, θ0θ0, with time. The default value is an empty string.Note:Use None in an Abaqus/Standard analysis to specify that the reference sink temperature is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference sink temperature is applied throughout the step.

  • filmCoeff (float, default: 0) – A Float specifying the reference film coefficient value, hh. The filmCoeff argument applies when definition = EMBEDDED_COEFF, definition = USER_SUB, or definition = FIELD. The default value is 0.0.

  • filmCoeffAmplitude (str, default: '') – A String specifying the name of the Amplitude object that gives the variation of the film coefficient, hh, with time. The default value is an empty string.Note:Use None in an Abaqus/Standard analysis to specify that the reference film coefficient is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference film coefficient is applied throughout the step.

  • sinkFieldName (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object associated with the sink temperature. The sinkFieldName argument applies only when sinkDistributionType = ANALYTICAL_FIELD or sinkDistributionType = DISCRETE_FIELD. The default value is an empty string.

  • sinkDistributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the sink temperature is distributed. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

Returns:

A ConcentratedFilmCondition object.

Return type:

ConcentratedFilmCondition

ConcentratedRadiationToAmbient(name, createStepName, region, ambientTemperature, ambientTemperatureAmp, emissivity, nodalArea=1, explicitRegionType=abaqusConstants.LAGRANGIAN, field='', distributionType=abaqusConstants.UNIFORM)[source]

This method creates a ConcentratedRadiationToAmbient object.

Note

This function can be accessed by:

mdb.models[name].ConcentratedRadiationToAmbient

Note

Check ConcentratedRadiationToAmbient on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the ConcentratedRadiationToAmbient object is created.

  • region (Region) – A Region object specifying the region to which the concentrated radiation interaction is applied. The interaction is applied to each node in the region.

  • ambientTemperature (float) – A Float specifying the reference ambient temperature, θ0θ0.

  • ambientTemperatureAmp (str) – A String specifying the name of the Amplitude object that gives the variation of the ambient temperature with time.Note:Use None in an Abaqus/Standard analysis to specify that the reference ambient temperature is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference ambient temperature is applied throughout the step.

  • emissivity (float) – A Float specifying the emissivity, ϵϵ.

  • nodalArea (float, default: 1) – A Float specifying the area associated with the node where the concentrated radiation interaction is applied. The default value is 1.0.

  • explicitRegionType (SymbolicConstant, default: LAGRANGIAN) – A SymbolicConstant specifying how the concentrated radiation is applied to the boundary of an adaptive mesh domain. Possible values are LAGRANGIAN, SLIDING, and EULERIAN. The default value is LAGRANGIAN.Note:explicitRegionType applies only during an Abaqus/Explicit analysis.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when distributionType = ANALYTICAL_FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the radiation is defined. Possible values are UNIFORM and ANALYTICAL_FIELD. The default value is UNIFORM.

Returns:

A ConcentratedRadiationToAmbient object.

Return type:

ConcentratedRadiationToAmbient

ContactExp(name, createStepName, useAllstar=OFF, globalSmoothing=ON, includedPairs=None, excludedPairs=None, contactPropertyAssignments=None, surfaceThicknessAssignments=None, surfaceOffsetAssignments=None, surfaceFeatureAssignments=None, smoothingAssignments=None, surfaceCrushTriggerAssignments=<abaqus.Interaction.SurfaceCrushTriggerAssignment.SurfaceCrushTriggerAssignment object>, surfaceFrictionAssignments=<abaqus.Interaction.SurfaceFrictionAssignment.SurfaceFrictionAssignment object>, mainSecondaryAssignments=None, polarityAssignments=<abaqus.Interaction.PolarityAssignments.PolarityAssignments object>)[source]

This method creates a ContactExp object.

Note

This function can be accessed by:

mdb.models[name].ContactExp

Note

Check ContactExp on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which this contact interaction is created.

  • useAllstar (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the contacting surface pair consists of all exterior faces, shell edges, beam segments, analytical rigid surfaces, and, when applicable, Eulerian material surfaces.

  • globalSmoothing (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether surface smoothing (geometric correction) is automatically applied to all eligible surfaces. The default value is ON.

  • includedPairs (Optional[RegionPairs], default: None) – A RegionPairs object specifying the domain pairs included in contact.

  • excludedPairs (Optional[RegionPairs], default: None) – A RegionPairs object specifying the domain pairs excluded from contact.

  • contactPropertyAssignments (Optional[ContactPropertyAssignment], default: None) – A ContactPropertyAssignment object specifying the contact property assignments in the contact domain.

  • surfaceThicknessAssignments (Optional[SurfaceThicknessAssignment], default: None) – A SurfaceThicknessAssignment object specifying the surface thickness assignments in the contact domain.

  • surfaceOffsetAssignments (Optional[SurfaceOffsetAssignment], default: None) – A SurfaceOffsetAssignment object specifying the surface offset fraction assignments in the contact domain.

  • surfaceFeatureAssignments (Optional[SurfaceFeatureAssignment], default: None) – A SurfaceFeatureAssignment object specifying the surface feature angle assignments in the contact domain.

  • smoothingAssignments (Optional[SmoothingAssignment], default: None) – A SmoothingAssignment object specifying the surface smoothing assignments in the contact domain.

  • surfaceCrushTriggerAssignments (SurfaceCrushTriggerAssignment, default: <abaqus.Interaction.SurfaceCrushTriggerAssignment.SurfaceCrushTriggerAssignment object at 0x7f99933a3a30>) –

    A SurfaceCrushTriggerAssignment object specifying the surface crush trigger assignments in the contact domain.

    New in version 2021: The surfaceCrushTriggerAssignments argument was added.

  • surfaceFrictionAssignments (SurfaceFrictionAssignment, default: <abaqus.Interaction.SurfaceFrictionAssignment.SurfaceFrictionAssignment object at 0x7f9993568970>) –

    A SurfaceFrictionAssignment object specifying the surface friction assignments in the contact domain.

    New in version 2021: The surfaceFrictionAssignments argument was added.

  • mainSecondaryAssignments (Optional[MasterSlaveAssignment], default: None) – A MasterSlaveAssignment object specifying the master-slave assignments in the contact domain.

  • polarityAssignments (PolarityAssignments, default: <abaqus.Interaction.PolarityAssignments.PolarityAssignments object at 0x7f99934939d0>) –

    A PolarityAssignments object specifying the polarity assignments in the contact domain.

    New in version 2020: The polarityAssignments argument was added.

Returns:

A ContactExp object.

Return type:

ContactExp

ContactProperty(name)[source]

This method creates a ContactProperty object.

Note

This function can be accessed by:

mdb.models[name].ContactProperty

Note

Check ContactProperty on help.3ds.com/2021.

Parameters:

name (str) – A String specifying the interaction property repository key.

Returns:

A ContactProperty object.

Return type:

ContactProperty

ContactStd(name, createStepName, useAllstar=OFF, globalSmoothing=ON, includedPairs=None, excludedPairs=None, contactPropertyAssignments=None, surfaceThicknessAssignments=None, surfaceOffsetAssignments=None, surfaceFeatureAssignments=None, surfaceBeamSmoothingAssignments=<abaqus.Interaction.SurfaceBeamSmoothingAssignment.SurfaceBeamSmoothingAssignment object>, surfaceVertexCriteriaAssignments=<abaqus.Interaction.SurfaceVertexCriteriaAssignment.SurfaceVertexCriteriaAssignment object>, slidingFormulationAssignments=None, mainSecondaryAssignments=None, initializationAssignments=None, stabilizationAssignments=None, smoothingAssignments=None, slidingTransitionAssignments=None)[source]

This method creates a ContactStd object.

Note

This function can be accessed by:

mdb.models[name].ContactStd

Note

Check ContactStd on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which this contact interaction is created.

  • useAllstar (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the contacting surface pairs consist of all exterior faces in the model.

  • globalSmoothing (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether surface smoothing (geometric correction) is automatically applied to all eligible surfaces. The default value is ON.

  • includedPairs (Optional[RegionPairs], default: None) – A RegionPairs object specifying the domain pairs included in contact.

  • excludedPairs (Optional[RegionPairs], default: None) – A RegionPairs object specifying the domain pairs excluded from contact.

  • contactPropertyAssignments (Optional[ContactPropertyAssignment], default: None) – A ContactPropertyAssignment object specifying the contact property assignments in the contact domain.

  • surfaceThicknessAssignments (Optional[SurfaceThicknessAssignment], default: None) – A SurfaceThicknessAssignment object specifying the surface thickness assignments in the contact domain.

  • surfaceOffsetAssignments (Optional[SurfaceOffsetAssignment], default: None) – A SurfaceOffsetAssignment object specifying the surface offset fraction assignments in the contact domain.

  • surfaceFeatureAssignments (Optional[SurfaceFeatureAssignment], default: None) – A SurfaceFeatureAssignment object specifying the surface feature angle assignments in the contact domain.

  • surfaceBeamSmoothingAssignments (SurfaceBeamSmoothingAssignment, default: <abaqus.Interaction.SurfaceBeamSmoothingAssignment.SurfaceBeamSmoothingAssignment object at 0x7f99935a0df0>) –

    A SurfaceBeamSmoothingAssignment object specifying the surface beam smoothing assignments in the contact domain.

    New in version 2021: The surfaceBeamSmoothingAssignments argument was added.

  • surfaceVertexCriteriaAssignments (SurfaceVertexCriteriaAssignment, default: <abaqus.Interaction.SurfaceVertexCriteriaAssignment.SurfaceVertexCriteriaAssignment object at 0x7f999333b970>) –

    A SurfaceVertexCriteriaAssignment object specifying the surface vertex criteria assignments in the contact domain.

    New in version 2021: The surfaceVertexCriteriaAssignments argument was added.

  • slidingFormulationAssignments (Optional[Tuple[SlidingFormulationAssignment, ...]], default: None) –

    A sequence of tuples of SlidingFormulationAssignment specifying the sliding formulation assignments. Each tuple contains two entries:

    • A region object or the SymbolicConstant GLOBAL specifying the surface to which the sliding formulation attribute is assigned.

    • A SymbolicConstant specifying the overriding the smoothness value to be used for the first surface. Possible values of the SymbolicConstant are NONE and SMALL_SLIDING.

    New in version 2021: The slidingFormulationAssignments argument was added.

  • mainSecondaryAssignments (Optional[MasterSlaveAssignment], default: None) – A MasterSlaveAssignment object specifying the master-slave assignments in the contact domain.

  • initializationAssignments (Optional[InitializationAssignment], default: None) – An InitializationAssignment object specifying the contact initialization assignments in the contact domain.

  • stabilizationAssignments (Optional[StabilizationAssignment], default: None) – A StabilizationAssignment object specifying the contact stabilization assignments in the contact domain.

  • smoothingAssignments (Optional[SmoothingAssignment], default: None) – A SmoothingAssignment object specifying the surface smoothing assignments in the contact domain.

  • slidingTransitionAssignments (Optional[SlidingTransitionAssignment], default: None) – A SlidingTransitionAssignments object specifying the sliding transition assignments in the contact domain.

Returns:

A ContactStd object.

Return type:

ContactStd

CyclicSymmetry(name, createStepName, master, slave, repetitiveSectors, axisPoint1, axisPoint2, extractedNodalDiameter=abaqusConstants.ALL_NODAL_DIAMETER, lowestNodalDiameter=0, highestNodalDiameter=0, excitationNodalDiameter=0, adjustTie=ON, positionTolerance=0, positionToleranceMethod=abaqusConstants.COMPUTED_TOLERANCE)[source]

This method creates a CyclicSymmetry object.

Note

This function can be accessed by:

mdb.models[name].CyclicSymmetry

Note

Check CyclicSymmetry on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the cyclic symmetry interaction should be created.

  • master (Region) – A Region object specifying the master surface.

  • slave (Region) – A Region object specifying the slave surface.

  • repetitiveSectors (int) – An Int specifying the total number of sectors in the cyclic symmetric model.

  • axisPoint1 (Region) – A Region object specifying the first point of the axis of symmetry. The region should contain exactly one mesh node, vertex, interesting point, reference point, or datum point. In a two-dimensional model axisPoint1 is the only point used to define the axis of symmetry.

  • axisPoint2 (Region) – A Region object specifying the second point of the axis of symmetry. The region should contain exactly one mesh node, vertex, interesting point, reference point, or datum point. This point is ignored in a two-dimensional model.

  • extractedNodalDiameter (SymbolicConstant, default: ALL_NODAL_DIAMETER) – A SymbolicConstant specifying whether Abaqus should extract all possible nodal diameters or the nodal diameters between the user-specified values for lowestNodalDiameter and highestNodalDiameter. Possible values are ALL_NODAL_DIAMETER and SPECIFIED_NODAL_DIAMETER. The default value is ALL_NODAL_DIAMETER.

  • lowestNodalDiameter (int, default: 0) – An Int specifying the lowest nodal diameter to be used in the eigenfrequency analysis. The default value is 0.

  • highestNodalDiameter (int, default: 0) – An Int specifying the highest nodal diameter to be used in the eigenfrequency analysis. This argument value should be less than or equal to the half of the total number of sectors (as specified in the repetitiveSectors parameter). The default value is 0.

  • excitationNodalDiameter (int, default: 0) – An Int specifying the nodal diameter for which the modal-based steady-state dynamic analysis will be performed. This value should be greater than or equal to the lowest nodal diameter (specified in the lowestNodalDiameter parameter), and less than or equal to the highest nodal diameter (specified in the highestNodalDiameter parameter). The default value is 0.

  • adjustTie (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether or not to adjust the slave surface of the cyclic symmetry to tie it to the master surface. The default value is ON.

  • positionTolerance (float, default: 0) – A Float specifying the position tolerance. The*positionTolerance* argument applies only when positionToleranceMethod = SPECIFY_TOLERANCE. The default value is 0.0.

  • positionToleranceMethod (SymbolicConstant, default: COMPUTED_TOLERANCE) – A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED_TOLERANCE and SPECIFY_TOLERANCE. The default value is COMPUTED_TOLERANCE.

Returns:

A CyclicSymmetry object.

Return type:

CyclicSymmetry

ElasticFoundation(name, createStepName, surface, stiffness)[source]

This method creates an ElasticFoundation object.

Note

This function can be accessed by:

mdb.models[name].ElasticFoundation

Note

Check ElasticFoundation on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the ElasticFoundation object is created. createStepName must be set to ‘Initial’.

  • surface (Region) – A Region object specifying the surface to which the foundation applies.

  • stiffness (float) – A Float specifying the foundation stiffness per area (or per length for beams).

Returns:

An ElasticFoundation object.

Return type:

ElasticFoundation

ExpContactControl(name, globTrkChoice=abaqusConstants.DEFAULT, globTrkInc=None, fastLocalTrk=ON, scalePenalty=1, warpCheckPeriod=20, warpCutoff=20)[source]

This method creates an ExpContactControl object.

Note

This function can be accessed by:

mdb.models[name].ExpContactControl

Note

Check ExpContactControl on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the contact controls repository key.

  • globTrkChoice (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying whether or not the default value will be used for the maximum number of increments between global contact searches. Possible values are DEFAULT and SPECIFY. The default value is DEFAULT.

  • globTrkInc (Optional[int], default: None) – An Int specifying the maximum number of increments between global contact searches. The globTrkInc argument applies only when globTrkChoice = SPECIFY. The default value is 100 for surface-to-surface contact and 4 for self-contact.

  • fastLocalTrk (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to use the more computationally efficient local tracking method. The default value is ON.

  • scalePenalty (float, default: 1) – A Float specifying the factor by which Abaqus/Explicit will scale the default penalty stiffness to obtain the stiffnesses used for the penalty contact pairs. The default value is 1.0.

  • warpCheckPeriod (int, default: 20) – An Int specifying the number of increments between checks for highly warped facets on master surfaces. The default value is 20.

  • warpCutoff (float, default: 20) – A Float specifying the out-of-plane warping angle (in degrees), at which a facet will be considered to be highly warped. The default value is 20.0.

Returns:

An ExpContactControl object.

Return type:

ExpContactControl

Raises:

RangeError –

ExpInitialization(name, overclosureType=abaqusConstants.ADJUST, interferenceDistance=None, clearanceDistance=None, openingTolerance=None, overclosureTolerance=None, adjustNodalCoords=True, secondaryNodesetName=None, stepFraction=1)[source]

This method creates an ExpInitialization object.

Note

This function can be accessed by:

mdb.models[name].ExpInitialization

Note

Check ExpInitialization on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the contact initialization repository key.

  • overclosureType (SymbolicConstant, default: ADJUST) – A SymbolicConstant specifying the type of overclosure to be defined. Possible values are ADJUST, INTERFERENCE, and CLEARANCE. The default value is ADJUST.

  • interferenceDistance (Optional[float], default: None) – None or a Float specifying the interference distance. This argument is valid only when overclosureType = INTERFERENCE. The default value is None.

  • clearanceDistance (Optional[float], default: None) – None or a Float specifying the initial clearance distance. This argument is valid only when overclosureType = CLEARANCE and must be specified in that case. The default value is None.

  • openingTolerance (Optional[float], default: None) – None or a Float specifying the distance tolerance within which initial openings will undergo strain-free adjustments. This argument is not valid when overclosureType = INTERFERENCE unless a value has been specified for interferenceDistance. The default value is None.

  • overclosureTolerance (Optional[float], default: None) – None or a Float specifying the distance tolerance within which initial overclosures will undergo strain-free adjustments. The default value is None.

  • adjustNodalCoords (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to resolve clearances/overclosures by adjusting the nodal coordinates without creating strain in the model. adjustNodalCoords = True can be used only for clearances/overclosures defined in the first step of an analysis. The default value is True.

  • secondaryNodesetName (Optional[str], default: None) –

    A String specifying the name of the node set containing the secondary nodes to be included in the initial clearance specification. This argument is not valid when overclosureType = INTERFERENCE and if openingTolerance or overclosureTolerance is specified. The default value is None.

    Changed in version 2022: The argument slaveNodesetName was renamed to secondaryNodesetName.

  • stepFraction (float, default: 1) – A Float specifying the fraction of the step time (between 0.0 and 1.0) in which the interference fit has to be solved. The default value is 1.0. This argument is valid only when overclosureType = INTERFERENCE.

Returns:

An ExpInitialization object.

Return type:

ExpInitialization

Raises:

RangeError –

FilmCondition(name, createStepName, surface, definition, interactionProperty='', sinkTemperature=0, sinkAmplitude='', filmCoeff=0, filmCoeffAmplitude='', field='', sinkFieldName='', sinkDistributionType=abaqusConstants.UNIFORM)[source]

This method creates a FilmCondition object.

Note

This function can be accessed by:

mdb.models[name].FilmCondition

Note

Check FilmCondition on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the FilmCondition object is created.

  • surface (Region) – A Region object specifying the name of the surface to which the film condition interaction is applied.

  • definition (SymbolicConstant) – A SymbolicConstant specifying how the film condition is defined. Possible values are EMBEDDED_COEFF, PROPERTY_REF, USER_SUB, and FIELD.

  • interactionProperty (str, default: '') – A String specifying the name of the FilmConditionProp object associated with this interaction. The interactionProperty argument applies only when definition = PROPERTY_REF. The default value is an empty string.

  • sinkTemperature (float, default: 0) – A Float specifying the reference sink temperature, θ0θ0. The default value is 0.0.

  • sinkAmplitude (str, default: '') – A String specifying the name of the Amplitude object that gives the variation of the sink temperature, θ0θ0, with time. The default value is an empty string.Note:Use empty string in an Abaqus/Standard analysis to specify that the reference sink temperature is applied immediately at the beginning of the step or linearly over the step. Use empty string in an Abaqus/Explicit analysis to specify that the reference sink temperature is applied throughout the step.

  • filmCoeff (float, default: 0) – A Float specifying the reference film coefficient value, hh. The filmCoeff argument applies when definition = EMBEDDED_COEFF, definition = USER_SUB, or definition = FIELD. The default value is 0.0.

  • filmCoeffAmplitude (str, default: '') – A String specifying the name of the Amplitude object that gives the variation of the film coefficient, hh, with time. The default value is an empty string. Note: Use empty string in an Abaqus/Standard analysis to specify that the reference film coefficient is applied immediately at the beginning of the step or linearly over the step. Use empty string in an Abaqus/Explicit analysis to specify that the reference film coefficient is applied throughout the step.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when definition = FIELD. The default value is an empty string.

  • sinkFieldName (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object associated with the sink temperature. The sinkFieldName argument applies only when sinkDistributionType = ANALYTICAL_FIELD or sinkDistributionType = DISCRETE_FIELD. The default value is an empty string.

  • sinkDistributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the sink temperature is distributed. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

Returns:

A FilmCondition object.

Return type:

FilmCondition

FilmConditionProp(name, temperatureDependency=OFF, dependencies=0, property=())[source]

This method creates a FilmConditionProp object.

Note

This function can be accessed by:

mdb.models[name].FilmConditionProp

Note

Check FilmConditionProp on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • property (tuple, default: ()) –

    A sequence of sequences of Floats specifying the following:

    • The film coefficient, hh.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

Returns:

A FilmConditionProp object.

Return type:

FilmConditionProp

FluidCavity(name, createStepName, cavityPoint, cavitySurface, interactionProperty, ambientPressure=0, thickness=1, useAdiabatic=OFF, checkNormals=ON)[source]

This method creates an FluidCavity object.

Note

This function can be accessed by:

mdb.models[name].FluidCavity

Note

Check FluidCavity on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the FluidCavity object is created.

  • cavityPoint (Region) – A Region object specifying the fluid cavity reference point.

  • cavitySurface (Region) – A Region object specifying the surface forming the boundary of the fluid cavity.

  • interactionProperty (str) – A String specifying the FluidCavityProperty object associated with this interaction.

  • ambientPressure (float, default: 0) – A Float specifying the magnitude of the ambient pressure. The default value is 0.0.

  • thickness (float, default: 1) – A Float specifying the out-of-plane thickness of the surface for two-dimensional models. This argument is valid only when using two-dimensional models. The default value is 1.0.

  • useAdiabatic (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether adiabatic behavior is assumed for the ideal gas. This argument is valid only when interactionProperty specifies a pneumatic definition. The default value is OFF.

  • checkNormals (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the analysis will check the consistency of the surface normals. The default value is ON.

Returns:

A FluidCavity object.

Return type:

FluidCavity

FluidCavityProperty(name, definition=abaqusConstants.HYDRAULIC, fluidDensity=None, molecularWeight=None, useExpansion=OFF, expansionTempDep=OFF, expansionDependencies=0, referenceTemperature=0, expansionTable=(), useBulkModulus=OFF, bulkModulusTempDep=OFF, bulkModulusDependencies=0, bulkModulusTable=(), useCapacity=OFF, capacityType=abaqusConstants.POLYNOMIAL, capacityTempDep=OFF, capacityDependencies=0, capacityTable=())[source]

This method creates a FluidCavityProperty object.

Note

This function can be accessed by:

mdb.models[name].FluidCavityProperty

Note

Check FluidCavityProperty on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • definition (SymbolicConstant, default: HYDRAULIC) – A SymbolicConstant specifying the type of fluid cavity property to be defined. Possible values are HYDRAULIC and PNEUMATIC. The default value is HYDRAULIC.

  • fluidDensity (Optional[float], default: None) – None or a Float specifying the reference fluid density. This argument is applicable only when definition = HYDRAULIC, and is required in that case. The default value is None.

  • molecularWeight (Optional[float], default: None) – None or a Float specifying the molecular weight of the ideal gas species. This argument is applicable only when definition = PNEUMATIC, and is required in that case. The default value is None.

  • useExpansion (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether thermal expansion coefficients will be defined. This argument is applicable only when definition = HYDRAULIC. The default value is OFF.

  • expansionTempDep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the thermal fluid expansion data will have temperature dependency. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. The default value is OFF.

  • expansionDependencies (int, default: 0) – An Int specifying the number of field variable dependencies in the thermal fluid expansion data. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. The default value is 0.

  • referenceTemperature (float, default: 0) – A Float specifying the reference temperature for the coefficient of thermal expansion. This argument is applicable only when definition = HYDRAULIC, when useExpansion = True, and when either expansionTempDep = True or when expansionDependencies is greater than 0. The default value is 0.0.

  • expansionTable (tuple, default: ()) –

    A sequence of sequences of Floats specifying the thermal expansion coefficients. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. Each sequence contains the following data:

    • The mean coefficient of thermal expansion.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • useBulkModulus (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether fluid bulk modulus values will be defined. This argument is applicable only when definition = HYDRAULIC. The default value is OFF.

  • bulkModulusTempDep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the fluid bulk modulus data will have temperature dependency. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. The default value is OFF.

  • bulkModulusDependencies (int, default: 0) – An Int specifying the number of field variable dependencies in the fluid bulk modulus data. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. The default value is 0.

  • bulkModulusTable (tuple, default: ()) –

    A sequence of sequences of Floats specifying the fluid bulk modulus values. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. Each sequence contains the following data:

    • The fluid bulk modulus.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

  • useCapacity (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether molar heat capacity values will be defined. This argument is applicable only when definition = PNEUMATIC. The default value is OFF.

  • capacityType (SymbolicConstant, default: POLYNOMIAL) – A SymbolicConstant specifying the method to define the molar heat capacity. Possible values are POLYNOMIAL and TABULAR. The default value is POLYNOMIAL.

  • capacityTempDep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the molar heat capacity data will have temperature dependency. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. The default value is OFF.

  • capacityDependencies (int, default: 0) – An Int specifying the number of field variable dependencies in the molar heat capacity data. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. The default value is 0.

  • capacityTable (tuple, default: ()) –

    A sequence of sequences of Floats specifying the molar heat capacity values in the form of a polynomial expression. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = POLYNOMIAL. In this form, only one sequence is specified and that sequence contains the following data:

    • The first molar heat capacity coefficient.

    • The second molar heat capacity coefficient.

    • The third molar heat capacity coefficient.

    • The fourth molar heat capacity coefficient.

    • The fifth molar heat capacity coefficient.

    Alternatively, the sequence data may specify the molar heat capacity values at constant pressure for an ideal gas species. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. Each sequence contains the following data:

    • The molar heat capacity at constant pressure.

    • Temperature, if the data depend on temperature.

    • Value of the first field variable, if the data depend on field variables.

    • Value of the second field variable.

    • Etc.

Returns:

A FluidCavityProperty object.

Return type:

FluidCavityProperty

FluidExchange(name, createStepName, firstCavity, interactionProperty, definition=abaqusConstants.TO_ENVIRONMENT, secondCavity='', exchangeArea=1)[source]

This method creates an FluidExchange object.

Note

This function can be accessed by:

mdb.models[name].FluidExchange

Note

Check FluidExchange on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the FluidExchange object is created.

  • firstCavity (str) – A String specifying the first FluidCavity object associated with this interaction. This will be the only cavity specified if definition = TO_ENVIRONMENT.

  • interactionProperty (str) – A String specifying the FluidExchangeProperty object associated with this interaction.

  • definition (SymbolicConstant, default: TO_ENVIRONMENT) – A SymbolicConstant specifying the type of fluid exchange to be defined. Possible values are TO_ENVIRONMENT and BETWEEN_CAVITIES. The default value is TO_ENVIRONMENT.

  • secondCavity (str, default: '') – A String specifying the second FluidCavity object associated with this interaction. This argument is applicable only when definition = BETWEEN_CAVITIES.

  • exchangeArea (float, default: 1) – A Float specifying the effective exchange area. The default value is 1.0.

Returns:

A FluidExchange object.

Return type:

FluidExchange

FluidExchangeProperty(name, dataTable, definition=abaqusConstants.BULK_VISCOSITY, pressureDependency=OFF, temperatureDependency=OFF, fieldDependencies=0)[source]

This method creates a FluidExchangeProperty object.

Note

This function can be accessed by:

mdb.models[name].FluidExchangeProperty

Note

Check FluidExchangeProperty on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • dataTable (tuple) –

    A sequence of sequences of Floats specifying the viscous and hydrodynamic resistance coefficients when definition = BULK_VISCOSITY. Each sequence contains the following data:

    • The viscous resistance coefficient.

    • The hydrodynamic resistance coefficient.

    • The average absolute pressure, if the data depend on pressure.

    • The average temperature, if the data depend on temperature.

    • The value of the first field variable, if the data depend on field variables.

    • The value of the second field variable.

    • Etc.

    Alternatively, the sequence data may specify the mass flow rate. This is applicable only when definition = MASS_FLUX. In this form, only one sequence is specified and that sequence contains the following data:

    • The mass flow rate per unit area.

    Alternatively, the sequence data may specify the mass rate leakage. This is applicable only when definition = MASS_RATE_LEAK. Each sequence contains the following data:

    • The absolute value of the mass flow rate per unit area. (The first tabular value entered must always be zero.)

    • The absolute value of the pressure difference. (The first tabular value entered must always be zero.)

    • The average absolute pressure, if the data depend on pressure.

    • The average temperature, if the data depend on temperature.

    • The value of the first field variable, if the data depend on field variables.

    • The value of the second field variable.

    • Etc.

    Alternatively, the sequence data may specify the volume flow rate. This is applicable only when definition = VOL_FLUX. In this form, only one sequence is specified and that sequence contains the following data:

    • The volumetric flow rate per unit area.

    Alternatively, the sequence data may specify the volume rate leakage. This is applicable only when definition = VOL_RATE_LEAK. Each sequence contains the following data:

    • The absolute value of the volumetric flow rate per unit area. (The first tabular value entered must always be zero.)

    • The absolute value of the pressure difference. (The first tabular value entered must always be zero.)

    • The average absolute pressure, if the data depend on pressure.

    • The average temperature, if the data depend on temperature.

    • The value of the first field variable, if the data depend on field variables.

    • The value of the second field variable.

    • Etc.

  • definition (SymbolicConstant, default: BULK_VISCOSITY) – A SymbolicConstant specifying the type of fluid exchange property to be defined. Possible values are BULK_VISCOSITY, MASS_FLUX, MASS_RATE_LEAK, VOL_FLUX, and VOL_RATE_LEAK. The default value is BULK_VISCOSITY.

  • pressureDependency (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the data will have pressure dependency. This argument is applicable only when definition = BULK_VISCOSITY, or when definition = MASS_RATE_LEAK, or when definition = VOL_RATE_LEAK. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the data will have temperature dependency. This argument is applicable only when definition = BULK_VISCOSITY, or when definition = MASS_RATE_LEAK, or when definition = VOL_RATE_LEAK. The default value is OFF.

  • fieldDependencies (int, default: 0) – An Int specifying the number of field variable dependencies in the data. This argument is applicable only when definition = BULK_VISCOSITY, or when definition = MASS_RATE_LEAK, or when definition = VOL_RATE_LEAK. The default value is 0.

Returns:

A FluidExchangeProperty object.

Return type:

FluidExchangeProperty

FluidInflator(name, createStepName, cavity, interactionProperty, inflationTimeAmplitude='', massFlowAmplitude='')[source]

This method creates a FluidInflator object.

Note

This function can be accessed by:

mdb.models[name].FluidInflator

New in version 2019: The FluidInflator method was added.

Note

Check FluidInflator on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the FluidInflator object is created.

  • cavity (str) – A String specifying the first FluidCavity object associated with this interaction.

  • interactionProperty (str) – A String specifying the FluidInflatorProperty object associated with this interaction.

  • inflationTimeAmplitude (str, default: '') – A string specifying the name of the amplitude curve defining a mapping between the inflation time and the actual time.

  • massFlowAmplitude (str, default: '') – A string specifying the name of the amplitude curve by which to modify the mass flow rate.

Return type:

A FluidInflator object.

FluidInflatorProperty(name, definition, effectiveArea, tankVolume, dischargeCoefficient=None, dataTable=(), numFluids=None, mixtureType='', inflationTime=(), fluidbehaviorName=(), massFraction=())[source]

This method creates a FluidInflatorProperty object.

Note

This function can be accessed by:

mdb.models[name].FluidInflatorProperty

New in version 2019: The FluidInflatorProperty method was added.

Note

Check FluidInflatorProperty on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • definition (str) – A Symbolic constant specifying the method used for modeling the flow characteristics of inflators. The default value is definition = DUAL PRESSURE. The possible values are DUAL PRESSURE, PRESSURE AND MASS, TANK TEST, and TEMPERATURE AND MASS.

  • effectiveArea (float) – A Float specifying the total inflator orifice area. This argument is applicable only if definition = DUAL PRESSURE or definition = PRESSURE AND MASS.

  • tankVolume (float) – A Float specifying the tank volume. This argument is applicable only if definition = DUAL PRESSURE or definition = TANK TEST.

  • dischargeCoefficient (Optional[float], default: None) – A Float specifying the discharge coefficient. This argument is applicable only if definition = DUAL PRESSURE or definition = PRESSURE AND MASS.

  • dataTable (tuple, default: ()) – A sequence of sequences of Floats specifying the items described in the “Table data” section below.

  • numFluids (Optional[int], default: None) – An Int specifying the number of gas species used for this inflator.

  • mixtureType (str, default: '') – A Symbolic constant specifying whether to use mass fraction or the molar fraction for a mixture of ideal gases. The default value is MASS FRACTION. The possible values are MASS FRACTION or MOLAR FRACTION.

  • inflationTime (tuple, default: ()) – A sequence of sequences of Floats specifying the inflation time.

  • fluidbehaviorName (tuple, default: ()) – A sequence of sequences of Strings specifying fluid behavior names.

  • massFraction (tuple, default: ()) – A sequence of sequences of Floats specifying the mass fraction or the molar fraction corresponding to entered fluid behavior.

Return type:

A FluidInflatorProperty object.

IncidentWave(name, createStepName, sourcePoint, standoffPoint, surface, interactionProperty, definition=abaqusConstants.PRESSURE, amplitude='', imaginaryAmplitude='', surfaceNormal=(), initialDepth=None, referenceMagnitude=None, detonationTime=None, magnitudeFactor=1)[source]

This method creates an IncidentWave object.

Note

This function can be accessed by:

mdb.models[name].IncidentWave

Note

Check IncidentWave on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the IncidentWave object is created.

  • sourcePoint (Region) – A Region object specifying the incident wave source point.

  • standoffPoint (Region) – A Region object specifying the incident wave standoff point.This argument is not valid when definition = CONWEP.

  • surface (Region) – A Region object specifying the surface defining the incident wave interaction. In problems involving fluid/surface boundaries, both the fluid surface and the solid surface comprising the boundary must have an incident wave interaction specified.

  • interactionProperty (str) – A String specifying the IncidentWaveProperty object associated with this interaction.

  • definition (SymbolicConstant, default: PRESSURE) – A SymbolicConstant specifying the type of incident wave to be defined. The value must be PRESSURE for linear perturbation steps. An Explicit step is required when the value is set to CONWEP. Possible values are PRESSURE, ACCELERATION, UNDEX, and CONWEP. The default value is PRESSURE.

  • amplitude (str, default: '') – A String specifying the name of the Amplitude object that defines the fluid pressure time history at the standoff point, if definition = PRESSURE. If definition = ACCELERATION, then this string specifies the name of the Amplitude object that defines the fluid particle acceleration time history at the standoff point. This member can be specified only if definition = PRESSURE or ACCELERATION. The default value is an empty string.

  • imaginaryAmplitude (str, default: '') – A String specifying the name of the Amplitude object that defines the imaginary component of the fluid pressure time history at the standoff point. This member is applicable only for linear perturbation steps and if definition = PRESSURE. The default value is an empty string.

  • surfaceNormal (tuple, default: ()) – A sequence of three Floats specifying the X, Y, and Z components of the direction cosine of the fluid surface normal.This argument is valid only when definition = UNDEX.

  • initialDepth (Optional[float], default: None) – None or a Float specifying the initial depth of the UNDEX bubble. The default value is None.This argument is valid only when definition = UNDEX.

  • referenceMagnitude (Optional[float], default: None) – A Float specifying the reference magnitude.This argument is not valid when definition = CONWEP.

  • detonationTime (Optional[float], default: None) – A Float specifying the time of detonation, given in total time.This argument is valid only when definition = CONWEP.

  • magnitudeFactor (float, default: 1) – A Float specifying the magnitude scale factor. The default value is 1.0.This argument is valid only when definition = CONWEP.

Returns:

An IncidentWave object.

Return type:

IncidentWave

IncidentWaveProperty(name, definition=abaqusConstants.PLANAR, propagationModel=abaqusConstants.ACOUSTIC, soundSpeed=None, fluidDensity=None, specificHeatRatio=None, gravity=None, atmosphericPressure=None, dragCoefficient=None, dragExponent=2, waveEffects=ON, chargeDensity=None, chargeMass=None, constantK1=None, constantK2=None, constantA=None, constantB=None, constantKc=None, duration=None, maximumSteps=1500, relativeStepControl=None, absoluteStepControl=None, stepControlExponent=0, genDecayA=0, genDecayB=0, genDecayC=0, seedNumber=None, massTNT=None, massFactor=1, lengthFactor=1, timeFactor=1, pressureFactor=1)[source]

This method creates an IncidentWaveProperty object.

Note

This function can be accessed by:

mdb.models[name].IncidentWaveProperty

Note

Check IncidentWaveProperty on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the interaction property repository key.

  • definition (SymbolicConstant, default: PLANAR) – A SymbolicConstant specifying the type of wave to be defined. Possible values are PLANAR, SPHERICAL, DIFFUSE, AIR_BLAST, and SURFACE_BLAST. The default value is PLANAR.

  • propagationModel (SymbolicConstant, default: ACOUSTIC) – A SymbolicConstant specifying the spherical propagation model. Possible values are ACOUSTIC, UNDEX_CHARGE, and GENERALIZED_DECAY. The default value is ACOUSTIC.This argument is valid only when definition = SPHERICAL.

  • soundSpeed (Optional[float], default: None) – A Float specifying the speed of sound in the fluid.This argument is not valid when definition = AIR_BLAST or when definition = SURFACE_BLAST.

  • fluidDensity (Optional[float], default: None) – A Float specifying the fluid mass density.This argument is not valid when definition = AIR_BLAST or when definition = SURFACE_BLAST.

  • specificHeatRatio (Optional[float], default: None) – None or a Float specifying the ratio of specific heats for gas. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • gravity (Optional[float], default: None) – None or a Float specifying the acceleration due to gravity. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • atmosphericPressure (Optional[float], default: None) – None or a Float specifying the atmospheric pressure. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • dragCoefficient (Optional[float], default: None) – None or a Float specifying the fluid drag coefficient. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • dragExponent (float, default: 2) – A Float specifying the fluid drag exponent. The default value is 2.0.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • waveEffects (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether or not to include wave effects in the fluid and gas. The default value is ON.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • chargeDensity (Optional[float], default: None) – None or a Float specifying the density of the charge material. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • chargeMass (Optional[float], default: None) – None or a Float specifying the mass of the charge material. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • constantK1 (Optional[float], default: None) – None or a Float specifying the charge material constant K. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • constantK2 (Optional[float], default: None) – None or a Float specifying the charge material constant k. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • constantA (Optional[float], default: None) – None or a Float specifying the charge material constant A. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • constantB (Optional[float], default: None) – None or a Float specifying the charge material constant B. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • constantKc (Optional[float], default: None) – None or a Float specifying the charge material constant Kc. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • duration (Optional[float], default: None) – None or a Float specifying the time duration for the bubble simulation. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • maximumSteps (int, default: 1500) – An Int specifying the maximum number of time steps for the bubble simulation. The default value is 1500.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • relativeStepControl (Optional[float], default: None) – A Float specifying the relative step size control parameter. The default value is 1x10-11.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • absoluteStepControl (Optional[float], default: None) – A Float specifying the absolute step size control parameter. The default value is 1x10-11.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • stepControlExponent (float, default: 0) – A Float specifying the step size control exponent. The default value is 0.2.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.

  • genDecayA (float, default: 0) – A Float specifying the constant A associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.

  • genDecayB (float, default: 0) – A Float specifying the constant B associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.

  • genDecayC (float, default: 0) – A Float specifying the constant C associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.

  • seedNumber (Optional[int], default: None) – An Int specifying the seed number (N) for the diffuse source calculation. N2 sources will be used in the simulation.This argument is valid only when definition = DIFFUSE.

  • massTNT (Optional[float], default: None) – A Float specifying the equivalent mass of TNT, in any preferred mass unit.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.

  • massFactor (float, default: 1) – A Float specifying the multiplication factor to convert from the preferred mass unit to kilograms. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.

  • lengthFactor (float, default: 1) – A Float specifying the multiplication factor to convert from the analysis length unit to meters. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.

  • timeFactor (float, default: 1) – A Float specifying the multiplication factor to convert from the analysis time unit to seconds. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.

  • pressureFactor (float, default: 1) – A Float specifying the multiplication factor to convert from the analysis pressure unit to pascals. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.

Returns:

An IncidentWaveProperty object.

Return type:

IncidentWaveProperty

ModelChange(name, createStepName, isRestart=OFF, regionType=abaqusConstants.GEOMETRY, region=None, activeInStep=OFF, includeStrain=OFF)[source]

This method creates a ModelChange object.

Note

This function can be accessed by:

mdb.models[name].ModelChange

Note

Check ModelChange on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the ModelChange object is created.

  • isRestart (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether this interaction is being used solely to indicate that model change may be required in a subsequent restart analysis (either for elements or contact pairs). The default value is OFF.

  • regionType (SymbolicConstant, default: GEOMETRY) – A SymbolicConstant specifying the region selection type. This argument is valid only when isRestart = False. Possible values are GEOMETRY, SKINS, STRINGERS, and ELEMENTS. The default value is GEOMETRY.

  • region (Optional[Region], default: None) – A Region object specifying the elements to be removed or reactivated. This argument is valid only when isRestart = False.

  • activeInStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether elements are being removed or reactivated. This argument is valid only when isRestart = False. The default value is OFF.

  • includeStrain (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether stress/displacement elements are reactivated with strain. This argument is valid only when isRestart = False and when activeInStep = True. The default value is OFF.

Returns:

A ModelChange object.

Return type:

ModelChange

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

PressurePenetration(name, createStepName, contactInteraction, masterPoints, slavePoints, penetrationPressure, criticalPressure, amplitude=abaqusConstants.UNSET, penetrationTime=0)[source]

This method creates a PressurePenetration object.

Note

This function can be accessed by:

mdb.models[name].PressurePenetration

Note

Check PressurePenetration on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the PressurePenetration object is created.

  • contactInteraction (str) – A String specifying the name of the Surface-to-surface contact (Standard) interaction.

  • masterPoints (List[Region]) – A RegionArray object specifying the points on the master surface that are exposed to the fluid.

  • slavePoints (List[Region]) – A RegionArray object specifying the points on the slave surface that are exposed to the fluid.

  • penetrationPressure (float) – A tuple of Floats specifying the fluid pressure magnitude. For steady state dynamic analyses, a tuple of Complexes specifying the fluid pressure magnitude.

  • criticalPressure (float) – A tuple of Floats specifying the critical contact pressure below which fluid penetration starts to occur.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • penetrationTime (float, default: 0) – A Float specifying the fraction of the current step time over which the fluid pressure on newly penetrated contact surface segments is ramped up to the current magnitude. The default value is 0.001.

Returns:

A PressurePenetration object.

Return type:

PressurePenetration

RadiationToAmbient(name, createStepName, surface, emissivity, field='', distributionType=abaqusConstants.UNIFORM, radiationType=abaqusConstants.AMBIENT, ambientTemperature=0, ambientTemperatureAmp='')[source]

This method creates a RadiationToAmbient object.

Note

This function can be accessed by:

mdb.models[name].RadiationToAmbient

Note

Check RadiationToAmbient on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the RadiationToAmbient object is created.

  • surface (Region) – A Region object specifying the surface to which the radiation interaction is applied.

  • emissivity (float) – A Float specifying the emissivity, ϵϵ.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when distributionType = ANALYTICAL_FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the radiation is distributed. This argument applies only when radiationType = AMBIENT. Possible values are UNIFORM and ANALYTICAL_FIELD. The default value is UNIFORM.

  • radiationType (SymbolicConstant, default: AMBIENT) – A SymbolicConstant specifying whether to use the default surface radiation behavior, or the cavity radiation approximation. Possible values are AMBIENT and CAVITY. The default value is AMBIENT.

  • ambientTemperature (float, default: 0) – A Float specifying the reference ambient temperature, θ0θ0. This argument applies only when radiationType = AMBIENT. The default value is 0.0.

  • ambientTemperatureAmp (str, default: '') – A String specifying the name of the Amplitude object that gives the variation of the ambient temperature with time.Note:Use None in an Abaqus/Standard analysis to specify that the reference ambient temperature is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference ambient temperature is applied throughout the step. This argument applies only when radiationType = AMBIENT.

Returns:

A RadiationToAmbient object.

Return type:

RadiationToAmbient

SelfContactExp(name, createStepName, surface, interactionProperty, mechanicalConstraint=abaqusConstants.KINEMATIC, contactControls='')[source]

This method creates a SelfContactExp object.

Note

This function can be accessed by:

mdb.models[name].SelfContactExp

Note

Check SelfContactExp on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the SelfContactExp object is created.

  • surface (Region) – A Region object specifying the surface where self-contact is defined.

  • interactionProperty (str) – A String specifying the name of the ContactProperty object associated with this interaction.

  • mechanicalConstraint (SymbolicConstant, default: KINEMATIC) – A SymbolicConstant specifying the mechanical constraint formulation. Possible values are KINEMATIC and PENALTY. The default value is KINEMATIC.

  • contactControls (str, default: '') – A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.

Returns:

A SelfContactExp object.

Return type:

SelfContactExp

SelfContactStd(name, createStepName, surface, interactionProperty, enforcement=abaqusConstants.SURFACE_TO_SURFACE, thickness=ON, smooth=0, contactControls='')[source]

This method creates a SelfContactStd object.

Note

This function can be accessed by:

mdb.models[name].SelfContactStd

Note

Check SelfContactStd on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the SelfContactStd object is created.

  • surface (Region) – A Region object specifying the surface where self-contact is defined.

  • interactionProperty (str) – A String specifying the name of the ContactProperty object associated with this interaction.

  • enforcement (SymbolicConstant, default: SURFACE_TO_SURFACE) – A SymbolicConstant specifying the discretization method. Possible values are NODE_TO_SURFACE and SURFACE_TO_SURFACE. The default value is SURFACE_TO_SURFACE.

  • thickness (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether shell/membrane element thickness is considered. The default value is ON.This argument in valid only when enforcement = SURFACE_TO_SURFACE.

  • smooth (float, default: 0) – A Float specifying the degree of smoothing used for deformable or rigid master surfaces involved when enforcement = NODE_TO_SURFACE. The value given must lie between 0.0 and 0.5. The default value is 0.2.

  • contactControls (str, default: '') – A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.

Returns:

A SelfContactStd object.

Return type:

SelfContactStd

StdContactControl(name, stiffnessScaleFactor=1, penetrationTolChoice=abaqusConstants.RELATIVE, relativePenetrationTolerance=None, absolutePenetrationTolerance=None, frictionOnset=None, automaticTolerances=OFF, maxchp=0, perrmx=0, uerrmx=0, stabilizeChoice=abaqusConstants.NONE, dampFactor=1, dampCoef=0, tangFraction=1, eosFraction=0, zeroDampingChoice=abaqusConstants.COMPUTE, zeroDamping=None, enforceWithLagrangeMultipliers=abaqusConstants.DEFAULT)[source]

This method creates an StdContactControl object.

Note

This function can be accessed by:

mdb.models[name].StdContactControl

Note

Check StdContactControl on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the contact controls repository key.

  • stiffnessScaleFactor (float, default: 1) – A Float specifying the factor by which Abaqus/Standard will scale the default penalty stiffness to obtain the stiffnesses used for the contact pairs. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The default value is 1.0.

  • penetrationTolChoice (SymbolicConstant, default: RELATIVE) – A SymbolicConstant specifying whether the allowable penetration is an absolute value or a value relative to the characteristic contact surface face dimension. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. Possible values are RELATIVE and ABSOLUTE. The default value is RELATIVE.

  • relativePenetrationTolerance (Optional[float], default: None) – A Float specifying the ratio of the allowable penetration to the characteristic contact surface face dimension. The float values represent percentages (e.g.: 0.001=0.1%). Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The default value is 10-3.The relativePenetrationTolerance argument applies only when penetrationTolChoice = RELATIVE. The relativePenetrationTolerance and absolutePenetrationTolerance arguments are mutually exclusive.

  • absolutePenetrationTolerance (Optional[float], default: None) – None or a Float specifying the allowable penetration. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The absolutePenetrationTolerance argument applies only when penetrationTolChoice = ABSOLUTE. The relativePenetrationTolerance and absolutePenetrationTolerance arguments are mutually exclusive. The default value is None.

  • frictionOnset (Optional[SymbolicConstant], default: None) –

    A SymbolicConstant specifying when the application of friction occurs. Possible values are:

    • IMMEDIATE, specifying the friction is included in the increment when contact occurs.

    • DELAYED, specifying the application of friction is delayed until the increment after contact occurs.

  • automaticTolerances (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether Abaqus/Standard should automatically compute an overclosure tolerance and a separation tolerance to prevent chattering in contact. The default value is OFF.The automaticTolerances argument cannot be used with the maxchp, perrmx, and uerrmx arguments.

  • maxchp (int, default: 0) – An Int specifying the maximum number of points that are permitted to violate contact conditions in any increment. The default value is 0.Either the perrmx or the uerrmx argument must be specified in conjunction with the maxchp argument.

  • perrmx (float, default: 0) – A Float specifying the maximum value of tensile stress (tensile force in GAP- or ITT-type contact elements) allowed to be transmitted at a contact point. The default value is 0.0.The perrmx argument must be specified in conjunction with the maxchp argument.

  • uerrmx (float, default: 0) – A Float specifying the maximum overclosure distance allowed at a slave node that is considered to be open. The default value is 0.0.The uerrmx argument must be specified in conjunction with the maxchp argument.

  • stabilizeChoice (SymbolicConstant, default: NONE) – A SymbolicConstant specifying whether or not viscous damping will be specified, and if so, how it will be specified. Possible values are NONE, AUTOMATIC, and COEFFICIENT. The default value is NONE.

  • dampFactor (float, default: 1) – A Float specifying the value of the damping factor. This value is multiplied by the calculated damping coefficient. The default value is 1.0.This argument is only valid when stabilizeChoice = AUTOMATIC.

  • dampCoef (float, default: 0) – A Float specifying the damping coefficient. The default value is 0.0.This argument is only valid when stabilizeChoice = COEFFICIENT.

  • tangFraction (float, default: 1) – A Float specifying the tangential stabilization as a fraction of the normal stabilization (damping). The default value is 1.0.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.

  • eosFraction (float, default: 0) – A Float specifying the fraction of the damping that remains at the end of the step. The default value is 0.0.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.

  • zeroDampingChoice (SymbolicConstant, default: COMPUTE) – A SymbolicConstant specifying how the zero-damping clearance will be specified. Possible values are COMPUTE and SPECIFY. The default value is COMPUTE.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.

  • zeroDamping (Optional[float], default: None) – None or a Float specifying the clearance at which damping becomes zero. This argument is valid only when zeroDampingChoice = SPECIFY. This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT. The default value is None.

  • enforceWithLagrangeMultipliers (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying whether to enforce the contact constraints with Lagrange multipliers. Possible values are DEFAULT, ENFORCEMENT_OFF, and ENFORCEMENT_ON. The default value is DEFAULT.

Returns:

A StdContactControl object.

Return type:

StdContactControl

Raises:

RangeError –

StdInitialization(name, overclosureType=abaqusConstants.ADJUST, interferenceDistance=None, clearanceDistance=None, openingTolerance=None, overclosureTolerance=None)[source]

This method creates a StdInitialization object.

Note

This function can be accessed by:

mdb.models[name].StdInitialization

New in version 2020: The ExpInitialization method was added.

Note

Check StdInitialization on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the contact initialization repository key.

  • overclosureType (SymbolicConstant, default: ADJUST) – A SymbolicConstant specifying the type of overclosure to be defined. Possible values are ADJUST, INTERFERENCE, and CLEARANCE. The default value is ADJUST.

  • interferenceDistance (Optional[float], default: None) – None or a Float specifying the interference distance. This argument is valid only when overclosureType = INTERFERENCE. The default value is None.

  • clearanceDistance (Optional[float], default: None) – None or a Float specifying the initial clearance distance. This argument is valid only when overclosureType = CLEARANCE, and must be specified in that case. The default value is None.

  • openingTolerance (Optional[float], default: None) – None or a Float specifying the distance tolerance within which initial openings will undergo strain-free adjustments. This argument is not valid when overclosureType = INTERFERENCE unless a value has been specified for interferenceDistance. The default value is None.

  • overclosureTolerance (Optional[float], default: None) – None or a Float specifying the distance tolerance within which initial overclosures will undergo strain-free adjustments.. The default value is None.

Returns:

A StdInitialization object.

Return type:

StdInitialization

Raises:

RangeError –

StdStabilization(name, zeroDistance=None, reductionFactor=0, scaleFactor=1, tangentialFactor=0, amplitude='', reset=OFF)[source]

This method creates a StdStabilization object.

Note

This function can be accessed by:

mdb.models[name].StdStabilization

Note

Check StdStabilization on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the contact stabilization repository key.

  • zeroDistance (Optional[float], default: None) – None or a Float specifying the clearance distance at which the stabilization becomes zero. The default value is None.

  • reductionFactor (float, default: 0) – A Float specifying the factor by which the analysis will reduce the contact stabilization coefficient per increment. The default value is 0.1.

  • scaleFactor (float, default: 1) – A Float specifying the factor by which the analysis will scale the contact stabilization coefficient. The default value is 1.0.

  • tangentialFactor (float, default: 0) – A Float specifying the factor that scales the contact stabilization coefficient in the tangential direction. The default value is 0.0.

  • amplitude (str, default: '') – A String specifying the name of the Amplitude object that defines a time-dependent scale factor for contact stabilization over the step. The default value is an empty string.

  • reset (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to cancel carryover effects from contact stabilization specifications involving nondefault amplitudes that appeared in previous steps. The default value is OFF.

Returns:

A StdStabilization object.

Return type:

StdStabilization

Raises:

RangeError –

StdXplCosimulation(name, createStepName, region, incrementation=abaqusConstants.ALLOW_SUBCYCLING, stepSize=0, stepSizeDefinition=abaqusConstants.DEFAULT)[source]

This method creates a StdXplCosimulation object.

Note

This function can be accessed by:

mdb.models[name].StdXplCosimulation

Note

Check StdXplCosimulation on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the StdXplCosimulation object is created.

  • region (Region) – A Region object specifying the import and export region upon which the co-simulation exchanges data with the coupled analysis program.

  • incrementation (SymbolicConstant, default: ALLOW_SUBCYCLING) – A SymbolicConstant specifying whether the analysis programs use the same time increments or one is allowed to use more time increments than the other before exchanging data. Possible values are ALLOW_SUBCYCLING and LOCKSTEP. The default value is ALLOW_SUBCYCLING.

  • stepSize (float, default: 0) – A Float specifying the size of the increments to be used by Abaqus/Standard and Abaqus/Explicit. The default value is 0.0.

  • stepSizeDefinition (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying whether the increment size is the analysis default or a supplied variable. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.

Returns:

A StdXplCosimulation object.

Return type:

StdXplCosimulation

SurfaceToSurfaceContactExp(name, createStepName, master, slave, sliding, interactionProperty, mechanicalConstraint=abaqusConstants.KINEMATIC, weightingFactorType=abaqusConstants.DEFAULT, weightingFactor=0, contactControls='', initialClearance=abaqusConstants.OMIT, halfThreadAngle=None, pitch=None, majorBoltDiameter=abaqusConstants.COMPUTED, meanBoltDiameter=abaqusConstants.COMPUTED, datumAxis=None, useReverseDatumAxis=OFF, clearanceRegion=None)[source]

This method creates a SurfaceToSurfaceContactExp object.

Note

This function can be accessed by:

mdb.models[name].SurfaceToSurfaceContactExp

Note

Check SurfaceToSurfaceContactExp on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the SurfaceToSurfaceContactExp object is created.

  • master (Region) – A Region object specifying the main surface.

  • slave (Region) – A Region object specifying the secondary surface.

  • sliding (SymbolicConstant) – A SymbolicConstant specifying the contact formulation. Possible values are FINITE and SMALL.

  • interactionProperty (str) – A String specifying the name of the ContactProperty object associated with this interaction.

  • mechanicalConstraint (SymbolicConstant, default: KINEMATIC) – A SymbolicConstant specifying the mechanical constraint formulation. Possible values are KINEMATIC and PENALTY. The default value is KINEMATIC.

  • weightingFactorType (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the weighting for node-to-face contact. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.

  • weightingFactor (float, default: 0) – A Float specifying the weighting factor for the contact surfaces when weightingFactorType = SPECIFIED. The default value is 0.0.

  • contactControls (str, default: '') – A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.

  • initialClearance (Union[SymbolicConstant, float], default: OMIT) – A SymbolicConstant or a Float specifying the initial clearance at regions of contact. Possible values are OMIT and COMPUTED. The default value is OMIT.

  • halfThreadAngle (Optional[str], default: None) – None or a sequence of Floats specifying the half thread angle used for bolt clearance. The default value is None.

  • pitch (Optional[str], default: None) – None or a sequence of Floats specifying the pitch used for bolt clearance. The default value is None.

  • majorBoltDiameter (Union[SymbolicConstant, float], default: COMPUTED) – The SymbolicConstant COMPUTED or a Float specifying the major diameter of the bolt used for bolt clearance. The default value is COMPUTED.

  • meanBoltDiameter (Union[SymbolicConstant, float], default: COMPUTED) – The SymbolicConstant COMPUTED or a Float specifying the mean diameter of the bolt used for bolt clearance. The default value is COMPUTED.

  • datumAxis (Optional[DatumAxis], default: None) – A DatumAxis object specifying the orientation of the bolt hole when specifying bolt clearance.

  • useReverseDatumAxis (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to reverse the bolt clearance direction given by the datum axis. The default value is OFF.

  • clearanceRegion (Optional[Region], default: None) – A Region object specifying the contact region for which clearance is specified.

Returns:

A SurfaceToSurfaceContactExp object.

Return type:

SurfaceToSurfaceContactExp

SurfaceToSurfaceContactStd(name, createStepName, master, slave, sliding, interactionProperty, interferenceType=abaqusConstants.NONE, overclosure=0, interferenceDirectionType=abaqusConstants.COMPUTED, direction=(), amplitude='', smooth=0, hcrit=0, extensionZone=0, adjustMethod=abaqusConstants.NONE, adjustTolerance=0, adjustSet=None, enforcement=abaqusConstants.SURFACE_TO_SURFACE, thickness=ON, contactControls='', tied=OFF, initialClearance=abaqusConstants.OMIT, halfThreadAngle=None, pitch=None, majorBoltDiameter=abaqusConstants.COMPUTED, meanBoltDiameter=abaqusConstants.COMPUTED, datumAxis=None, useReverseDatumAxis=OFF, clearanceRegion=None, surfaceSmoothing=abaqusConstants.NONE, bondingSet=None, handedness=abaqusConstants.RIGHT, normalAdjustment=None)[source]

This method creates a SurfaceToSurfaceContactStd object.

Note

This function can be accessed by:

mdb.models[name].SurfaceToSurfaceContactStd

Note

Check SurfaceToSurfaceContactStd on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the SurfaceToSurfaceContactStd object is created.

  • master (Region) – A Region object specifying the master surface.

  • slave (Region) – A Region object specifying the slave surface.

  • sliding (SymbolicConstant) – A SymbolicConstant specifying the contact formulation. Possible values are FINITE and SMALL.

  • interactionProperty (str) – A String specifying the name of the ContactProperty object associated with this interaction.

  • interferenceType (SymbolicConstant, default: NONE) –

    A SymbolicConstant specifying the type of time-dependent allowable interference for contact pairs and contact elements. Possible values are:

    • NONE, specifying no allowable contact interference.

    • SHRINK_FIT.

    • UNIFORM.

    The default value is NONE.

  • overclosure (float, default: 0) – A Float specifying the maximum overclosure distance allowed. This argument applies only when interferenceType = UNIFORM. The default value is 0.0.

  • interferenceDirectionType (SymbolicConstant, default: COMPUTED) – A SymbolicConstant specifying the method used to determine the interference direction. Possible values are COMPUTED and DIRECTION_COSINE. The default value is COMPUTED.

  • direction (tuple, default: ()) –

    A sequence of three Floats specifying the following:

    • XX-direction cosine of the interference direction vector.

    • YY-direction cosine of the interference direction vector.

    • ZZ-direction cosine of the interference direction vector.

    This argument is required only when interferenceDirectionType = DIRECTION_COSINE.

  • amplitude (str, default: '') – A String specifying the name of the amplitude curve that defines the magnitude of the prescribed interference during the step. Use None to specify that the prescribed interference is applied immediately at the beginning of the step and ramped down to zero linearly over the step.

  • smooth (float, default: 0) – A Float specifying the degree of smoothing used for deformable or rigid master surfaces involved when enforcement = NODE_TO_SURFACE. The value given must lie between 0.0 and 0.5. The default value is 0.2.

  • hcrit (float, default: 0) – A Float specifying the distance by which a slave node must penetrate the master surface before Abaqus/Standard abandons the current increment and tries again with a smaller increment. The default value is 0.0.

  • extensionZone (float, default: 0) – A Float specifying a fraction of the end segment or facet edge length by which the master surface is to be extended to avoid numerical round-off errors associated with contact modeling. The value given must lie between 0.0 and 0.2. The default value is 0.1.

  • adjustMethod (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the adjust method. Possible values are NONE, OVERCLOSED, TOLERANCE, and SET. The default value is NONE.

  • adjustTolerance (float, default: 0) – A Float specifying the adjust tolerance. The default value is 0.0.

  • adjustSet (Optional[Region], default: None) – A Region object specifying the Set object to which the adjustment is to be applied.

  • enforcement (SymbolicConstant, default: SURFACE_TO_SURFACE) – A SymbolicConstant specifying the discretization method. Possible values are NODE_TO_SURFACE and SURFACE_TO_SURFACE. The default value is SURFACE_TO_SURFACE.

  • thickness (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether shell/membrane element thickness is considered. The default value is ON.This argument is not valid when sliding = FINITE and enforcement = NODE_TO_SURFACE.

  • contactControls (str, default: '') – A String specifying the name of the ContactControl object associated with this interaction. The empty string indicates that the default contact controls will be used. The default value is an empty string.

  • tied (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the surfaces are to be “tied” together for the duration of the simulation. The default value is OFF.

  • initialClearance (Union[SymbolicConstant, float], default: OMIT) – A SymbolicConstant or a Float specifying the initial clearance at regions of contact. Possible values are OMIT and COMPUTED. The default value is OMIT.

  • halfThreadAngle (Optional[str], default: None) – None or a sequence of Floats specifying the half thread angle used for bolt clearance. The default value is None.

  • pitch (Optional[str], default: None) – None or a sequence of Floats specifying the pitch used for bolt clearance. The default value is None.

  • majorBoltDiameter (Union[SymbolicConstant, float], default: COMPUTED) – The SymbolicConstant COMPUTED or a Float specifying the major diameter of the bolt used for bolt clearance. The default value is COMPUTED.

  • meanBoltDiameter (Union[SymbolicConstant, float], default: COMPUTED) – The SymbolicConstant COMPUTED or a Float specifying the mean diameter of the bolt used for bolt clearance. The default value is COMPUTED.

  • datumAxis (Optional[DatumAxis], default: None) – A DatumAxis object specifying the orientation of the bolt hole when specifying bolt clearance.

  • useReverseDatumAxis (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to reverse the bolt clearance direction given by the datum axis. The default value is OFF.

  • clearanceRegion (Optional[Region], default: None) – A Region object specifying the contact region for which clearance is specified.

  • surfaceSmoothing (SymbolicConstant, default: NONE) – A SymbolicConstant specifying whether to use surface smoothing for geometric surfaces in SurfaceToSurfaceContactStd interactions. Possible values are AUTOMATIC and NONE. The default value is NONE.

  • bondingSet (Optional[Region], default: None) – A Region object specifying the slave node sub-set for bonding, used only when the contact property CohesiveBehavior option specifies use.

  • handedness (SymbolicConstant, default: RIGHT) –

    A SymbolicConstant specifying the bolt handedness formulation. Possible values are RIGHT and LEFT. The default value is RIGHT.

    New in version 2019: The normalAdjustment argument was added.

  • normalAdjustment (Optional[SymbolicConstant], default: None) –

    A SymbolicConstant specifying the bolt normal adjustment formulation for all slave nodes. Possible values are UNIFORM AXIAL COMPONENT and LOCATION DEPENDENT. The default value is UNIFORM AXIAL COMPONENT.

    New in version 2019: The normalAdjustment argument was added.

Returns:

A SurfaceToSurfaceContactStd object.

Return type:

SurfaceToSurfaceContactStd

XFEMCrackGrowth(name, createStepName, crackName, allowGrowth=ON)[source]

This method creates an XFEMCrackGrowth object.

Note

This function can be accessed by:

mdb.models[name].XFEMCrackGrowth

Note

Check XFEMCrackGrowth on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the XFEMCrackGrowth object is created.

  • crackName (str) – A String specifying the XFEMCrack object associated with this interaction.

  • allowGrowth (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the crack is allowed to grow (propagate) during this analysis step. The default value is ON.

Returns:

A XFEMCrackGrowth object.

Return type:

XFEMCrackGrowth

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactDetection(name='', createStepName='', searchDomain=abaqusConstants.MODEL, defaultType=abaqusConstants.CONTACT, interactionProperty='', separationTolerance=None, extendByAngle=20, mergeWithinAngle=20, searchSingleInstances=OFF, nameEachSurfaceFound=ON, createUnionOfMasterSurfaces=OFF, createUnionOfSlaveSurfaces=OFF, createUnionOfMasterSlaveSurfaces=OFF, includePlanar=ON, includeCylindricalSphericalToric=ON, includeSplineBased=ON, includeMeshSolid=ON, includeMeshShell=ON, includeMeshMembrane=OFF, includeOverclosed=ON, includeNonOverlapping=OFF, meshedGeometrySearchTechnique=abaqusConstants.USE_GEOMETRY, useShellThickness=ON, surfaceSmoothing=None)[source]

This method uses contact detection to create SurfaceToSurfaceContactStd, SurfaceToSurfaceContactExp, and Tie objects.

Note

Check Model.contactDetection on help.3ds.com/2021.

Parameters:

  • name (str, default: '') – A String specifying the prefix used to generate repository keys. The default value is “CP-”

  • createStepName (str, default: '') – A String specifying the name of the step in which the SurfaceToSurfaceContactStd, SurfaceToSurfaceContactExp, and Tie objects are created. The default value is “Initial.”

  • searchDomain (SymbolicConstant, default: MODEL) – A SymbolicConstant MODEL or a sequence of Strings specifying the names of instances to search. MODEL indicates the whole model is searched. The default value is MODEL.

  • defaultType (SymbolicConstant, default: CONTACT) – A SymbolicConstant specifying the default type of object to create. Possible values are CONTACT, CONTACT_STANDARD, CONTACT_EXPLICIT, and TIE. If CONTACT is used, the behavior is determined by the type of Step in the model. If an ExplicitDynamicsStep or TempDisplacementDynamicsStep exists, then SurfaceToSurfaceContactExp is created by default. Otherwise SurfaceToSurfaceContactStd is created by default. The default value is CONTACT.

  • interactionProperty (str, default: '') – A String specifying the name of the ContactProperty object associated with any interactions created.

  • separationTolerance (Optional[float], default: None) – A Float specifying the maximum separation for considering two surfaces to be candidates for contact, where separation is the maximum distance between the points of closest approach on the two surfaces. The default value is a function of the model.

  • extendByAngle (float, default: 20) – None or a Float specifying the angle for extending surface definitions to include adjacent faces. The default value is 20.

  • mergeWithinAngle (float, default: 20) – None or a Float specifying the angle for merging adjacent contact pairs that lie within the angle. The default value is 20.

  • searchSingleInstances (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include surface pairs within a single instance. The default value is OFF.

  • nameEachSurfaceFound (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to assign a name to each surface found. The default value is ON.

  • createUnionOfMasterSurfaces (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to create a surface that is the union of all master surfaces found. The default value is OFF.

  • createUnionOfSlaveSurfaces (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to create a surface that is the union of all slave surfaces found. The default value is OFF.

  • createUnionOfMasterSlaveSurfaces (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to create a surface that is the union of all master and slave surfaces found. The default value is OFF.

  • includePlanar (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include planar geometry. The default value is ON.

  • includeCylindricalSphericalToric (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include cylindrical, spherical, and toric geometry. The default value is ON.

  • includeSplineBased (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include spline-based geometry. The default value is ON.

  • includeMeshSolid (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include solid mesh entities. The default value is ON.

  • includeMeshShell (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include shell mesh entities. The default value is ON.

  • includeMeshMembrane (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include mesh membrane entities. The default value is OFF.

  • includeOverclosed (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include overclosed pairs. The default value is ON.

  • includeNonOverlapping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include opposing geometry surfaces that do not overlap. The default value is OFF.

  • meshedGeometrySearchTechnique (SymbolicConstant, default: USE_GEOMETRY) – A SymbolicConstant USE_GEOMETRY or USE_MESH specifying whether to locate pairs in meshed geometry using the geometric entities or mesh entities. The default value is USE_GEOMETRY.

  • useShellThickness (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to account for shell thickness and offset during contact detection. The default value is ON.

  • surfaceSmoothing (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying whether to use surface smoothing for geometric surfaces in SurfaceToSurfaceContactStd interactions. Possible values are NONE and AUTOMATIC. The default value isAUTOMATIC.

Return type:

None.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

getSurfaceSeparation()[source]

This method returns a list of all possible contacts that can be created using the ContactDetection method.

Returns:

Tuple of tuples, where each tuple holds information, to be used in contact creation as follows:

  • A string specifying the name of the master surface used in contact.

  • A string specifying the name of the slave surface used in contact.

  • A float specifying the separation distance between the master surface and the slave surface.

  • A boolean specifying whether or not contact surfaces are overclosed.

Return type:

Tuple[Tuple[str, str, float, bool], ]

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

LoadModel#

class LoadModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check LoadModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

BodyCharge(name, createStepName, region, ...)

This method creates a BodyCharge object.

BodyConcentrationFlux(name, createStepName, ...)

This method creates a BodyConcentrationFlux object.

BodyCurrent(name, createStepName, region, ...)

This method creates a BodyCurrent object.

BodyCurrentDensity(name, createStepName, ...)

This method creates a BodyCurrentDensity object.

BodyForce(name, createStepName, region[, ...])

This method creates a BodyForce object.

BodyHeatFlux(name, createStepName, region, ...)

This method creates a BodyHeatFlux object.

BoltLoad(name, createStepName, region, ...)

This method creates a BoltLoad object.

ConcCharge(name, createStepName, region, ...)

This method creates a ConcCharge object.

ConcConcFlux(name, createStepName, region, ...)

This method creates a ConcConcFlux object.

ConcCurrent(name, createStepName, region, ...)

This method creates a ConcCurrent object.

ConcentratedForce(name, createStepName, region)

This method creates a ConcentratedForce object.

ConcentratedHeatFlux(name, createStepName, ...)

This method creates a ConcentratedHeatFlux object.

ConcPoreFluid(name, createStepName, region, ...)

This method creates a ConcPoreFluid object.

ConnectorForce(name, createStepName[, ...])

This method creates a ConnectorForce object on a wire region.

ConnectorMoment(name, createStepName[, ...])

This method creates a ConnectorMoment object on a wire region.

CoriolisForce(name, createStepName, region, ...)

This method creates a CoriolisForce object.

Gravity(name, createStepName[, ...])

This method creates a Gravity object.

InertiaRelief(name, createStepName[, u1, ...])

This method creates an InertiaRelief object.

InwardVolAccel(name, createStepName, region, ...)

This method creates a InwardVolAccel object.

LineLoad(name, createStepName, region[, ...])

This method creates a LineLoad object.

Moment(name, createStepName, region[, cm1, ...])

This method creates a Moment object.

PEGLoad(name, createStepName, region[, ...])

This method creates a PEGLoad object.

PipePressure(name, createStepName, region, ...)

This method creates a Pressure object.

Pressure(name, createStepName, region[, ...])

This method creates a Pressure object.

RotationalBodyForce(name, createStepName, ...)

This method creates a RotationalBodyForce object.

ShellEdgeLoad(name, createStepName, region, ...)

This method creates a ShellEdgeLoad object.

SubmodelSB(name, createStepName, region, ...)

This method creates a SubmodelSB object.

SubstructureLoad(name, createStepName, ...)

This method creates a SubstructureLoad object.

SurfaceCharge(name, createStepName, region, ...)

This method creates a SurfaceCharge object.

SurfaceConcentrationFlux(name, ...[, field, ...])

This method creates a SurfaceConcentrationFlux object.

SurfaceCurrent(name, createStepName, region, ...)

This method creates a SurfaceCurrent object.

SurfaceCurrentDensity(name, createStepName, ...)

This method creates a SurfaceCurrentDensity object.

SurfaceHeatFlux(name, createStepName, ...[, ...])

This method creates a SurfaceHeatFlux object.

SurfacePoreFluid(name, createStepName, ...)

This method creates a SurfacePoreFluid object.

SurfaceTraction(name, createStepName, ...[, ...])

This method creates a SurfaceTraction object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
BodyCharge(name, createStepName, region, magnitude, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, field='')[source]

This method creates a BodyCharge object.

Note

This function can be accessed by:

mdb.models[name].BodyCharge

Note

Check BodyCharge on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

Returns:

A BodyCharge object.

Return type:

BodyCharge

BodyConcentrationFlux(name, createStepName, region, magnitude, field='', distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET)[source]

This method creates a BodyConcentrationFlux object.

Note

This function can be accessed by:

mdb.models[name].BodyConcentrationFlux

Note

Check BodyConcentrationFlux on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the body concentration flux magnitude. magnitude is optional if distributionType = USER_DEFINED.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the body concentration flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A BodyConcentrationFlux object.

Return type:

BodyConcentrationFlux

BodyCurrent(name, createStepName, region, magnitude, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, field='')[source]

This method creates a BodyCurrent object.

Note

This function can be accessed by:

mdb.models[name].BodyCurrent

Note

Check BodyCurrent on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

Returns:

A BodyCurrent object.

Return type:

BodyCurrent

BodyCurrentDensity(name, createStepName, region, comp1, comp2, comp3, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM)[source]

This method creates a BodyCurrentDensity object.

Note

This function can be accessed by:

mdb.models[name].BodyCurrentDensity

Note

Check BodyCurrentDensity on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • comp1 (str) – A Complex specifying the first component of the load.

  • comp2 (str) – A Complex specifying the second component of the load.

  • comp3 (str) – A Complex specifying the third component of the load.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

Returns:

A BodyCurrentDensity object.

Return type:

BodyCurrentDensity

BodyForce(name, createStepName, region, field='', distributionType=abaqusConstants.UNIFORM, comp1=None, comp2=None, comp3=None, amplitude=abaqusConstants.UNSET)[source]

This method creates a BodyForce object.

Note

This function can be accessed by:

mdb.models[name].BodyForce

Note

Check BodyForce on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • comp1 (Optional[float], default: None) – A Float or a Complex specifying the body force component in the 1-direction.Note:Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero unless distributionType = USER_DEFINED.

  • comp2 (Optional[float], default: None) – A Float or a Complex specifying the body force component in the 2-direction.

  • comp3 (Optional[float], default: None) – A Float or a Complex specifying the body force component in the 3-direction.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A BodyForce object.

Return type:

BodyForce

BodyHeatFlux(name, createStepName, region, magnitude, field='', distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET)[source]

This method creates a BodyHeatFlux object.

Note

This function can be accessed by:

mdb.models[name].BodyHeatFlux

Note

Check BodyHeatFlux on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the body heat flux magnitude. magnitude is optional if distributionType = USER_DEFINED.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the body heat flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A BodyHeatFlux object.

Return type:

BodyHeatFlux

BoltLoad(name, createStepName, region, magnitude, datumAxis, boltMethod=abaqusConstants.APPLY_FORCE, amplitude=abaqusConstants.UNSET, preTenSecPartLevel=False)[source]

This method creates a BoltLoad object.

Note

This function can be accessed by:

mdb.models[name].BoltLoad

Note

Check BoltLoad on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the bolt load magnitude.

  • datumAxis (DatumAxis) – A DatumAxis object specifying the orientation of the pre-tension section normal.Note: datumAxis is applicable only for Solid and Shell regions; it has no meaning for Wire regions.

  • boltMethod (SymbolicConstant, default: APPLY_FORCE) – A SymbolicConstant specifying the method of applying the bolt load. Possible values are APPLY_FORCE and ADJUST_LENGTH. The default value is APPLY_FORCE.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • preTenSecPartLevel (Union[AbaqusBoolean, bool], default: False) –

    A Boolean specifying whether the pre-tension section is to be defined at the part level. The default value is False. You should provide the preTenSecPartLevel argument only if the selected region belongs to a dependent part instance. A pre-tension section cannot be defined at the part level for independent and model instances.

    New in version 2018: The preTenSecPartLevel argument was added.

Returns:

A BoltLoad object.

Return type:

BoltLoad

Raises:

TextError –

ConcCharge(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET)[source]

This method creates a ConcCharge object.

Note

This function can be accessed by:

mdb.models[name].ConcCharge

Note

Check ConcCharge on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConcCharge object.

Return type:

ConcCharge

ConcConcFlux(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET)[source]

This method creates a ConcConcFlux object.

Note

This function can be accessed by:

mdb.models[name].ConcConcFlux

Note

Check ConcConcFlux on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConcConcFlux object.

Return type:

ConcConcFlux

ConcCurrent(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET)[source]

This method creates a ConcCurrent object.

Note

This function can be accessed by:

mdb.models[name].ConcCurrent

Note

Check ConcCurrent on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConcCurrent object.

Return type:

ConcCurrent

ConcPoreFluid(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET)[source]

This method creates a ConcPoreFluid object.

Note

This function can be accessed by:

mdb.models[name].ConcPoreFluid

Note

Check ConcPoreFluid on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConcPoreFluid object.

Return type:

ConcPoreFluid

ConcentratedForce(name, createStepName, region, distributionType=abaqusConstants.UNIFORM, field='', cf1=None, cf2=None, cf3=None, amplitude=abaqusConstants.UNSET, follower=OFF, localCsys=None)[source]

This method creates a ConcentratedForce object.

Note

This function can be accessed by:

mdb.models[name].ConcentratedForce

Note

Check ConcentratedForce on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • cf1 (Optional[float], default: None) – A Float or a Complex specifying the concentrated force component in the 1-direction. Although cf1, cf2, and cf3 are optional arguments, at least one of them must be nonzero.

  • cf2 (Optional[float], default: None) – A Float or a Complex specifying the concentrated force component in the 2-direction.

  • cf3 (Optional[float], default: None) – A Float or a Complex specifying the concentrated force component in the 3-direction.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • follower (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the direction of the force rotates with the rotation at each node of the region. You should provide the follower argument only if it is valid for the specified step. The default value is OFF.

  • localCsys (Optional[int], default: None) – None or a DatumCsys object specifying the local coordinate system of the load’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

Returns:

A ConcentratedForce object.

Return type:

ConcentratedForce

ConcentratedHeatFlux(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET, dof=11)[source]

This method creates a ConcentratedHeatFlux object.

Note

This function can be accessed by:

mdb.models[name].ConcentratedHeatFlux

Note

Check ConcentratedHeatFlux on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • dof (int, default: 11) – An Int specifying the degree of freedom of the node, to which the concentrated heat flux should be applied. The default value is 11.

Returns:

A ConcentratedHeatFlux object.

Return type:

ConcentratedHeatFlux

ConnectorForce(name, createStepName, region='', fastenerName='', fastenerSetName='', f1=None, f2=None, f3=None, amplitude=abaqusConstants.UNSET)[source]

This method creates a ConnectorForce object on a wire region. Alternatively, the load may also be applied to a wire set referenced from an assembled fastener template model.

Note

This function can be accessed by:

mdb.models[name].ConnectorForce

Note

Check ConnectorForce on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (str, default: '') – The wire region to which the load is applied. This argument is not valid when fastenerName and fastenerSetName are specified.

  • fastenerName (str, default: '') – A String specifying the name of the assembled fastener to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

  • fastenerSetName (str, default: '') – A String specifying the assembled fastener template model set to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

  • f1 (Optional[float], default: None) – A Float or a Complex specifying the connector force component in the connector’s local 1-direction.Note:Although f1, f2, and f3 are optional arguments, at least one of them must be nonzero.

  • f2 (Optional[float], default: None) – A Float or a Complex specifying the connector force component in the connector’s local 2-direction.

  • f3 (Optional[float], default: None) – A Float or a Complex specifying the connector force component in the connector’s local 3-direction.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConnectorForce object.

Return type:

ConnectorForce

ConnectorMoment(name, createStepName, region='', fastenerName='', fastenerSetName='', m1=None, m2=None, m3=None, amplitude=abaqusConstants.UNSET)[source]

This method creates a ConnectorMoment object on a wire region. Alternatively, the load may also be applied to a wire set referenced from an assembled fastener template model.

Note

This function can be accessed by:

mdb.models[name].ConnectorMoment

Note

Check ConnectorMoment on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (str, default: '') – The wire region to which the load is applied. This argument is not valid when fastenerName and fastenerSetName are specified.

  • fastenerName (str, default: '') – A String specifying the name of the assembled fastener to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

  • fastenerSetName (str, default: '') – A String specifying the assembled fastener template model set to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

  • m1 (Optional[float], default: None) – A Float or a Complex specifying the moment component in the connector’s local 4-direction.

  • m2 (Optional[float], default: None) – A Float or a Complex specifying the moment component in the connector’s local 5-direction.

  • m3 (Optional[float], default: None) – A Float or a Complex specifying the moment component in the connector’s local 6-direction.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConnectorMoment object.

Return type:

ConnectorMoment

CoriolisForce(name, createStepName, region, magnitude, point1, point2, amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, field='')[source]

This method creates a CoriolisForce object.

Note

This function can be accessed by:

mdb.models[name].CoriolisForce

Note

Check CoriolisForce on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • point1 (tuple) – A sequence of Floats specifying the first point on the axis of rotation for the load.

  • point2 (tuple) – A sequence of Floats specifying the second point on the axis of rotation for the load.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

Returns:

A CoriolisForce object.

Return type:

CoriolisForce

Gravity(name, createStepName, distributionType=abaqusConstants.UNIFORM, field='', region=None, comp1=None, comp2=None, comp3=None, amplitude=abaqusConstants.UNSET)[source]

This method creates a Gravity object.

Note

This function can be accessed by:

mdb.models[name].Gravity

Note

Check Gravity on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • region (Optional[Region], default: None) – A Region object specifying the region to which the load is applied.

  • comp1 (Optional[float], default: None) – A Float or a Complex specifying the component of the load in the 1-direction.Note:Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero.

  • comp2 (Optional[float], default: None) – A Float or a Complex specifying the component of the load in the 2-direction.

  • comp3 (Optional[float], default: None) – A Float or a Complex specifying the component of the load in the 3-direction.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A Gravity object.

Return type:

Gravity

InertiaRelief(name, createStepName, u1=OFF, u2=OFF, u3=OFF, ur1=OFF, ur2=OFF, ur3=OFF, referencePoint=(), localCoordinates=None)[source]

This method creates an InertiaRelief object.

Note

This function can be accessed by:

mdb.models[name].InertiaRelief

Note

Check InertiaRelief on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • u1 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the 1-direction as a free direction.Note:Although u1, u2, u3, ur1, ur2, and ur3 are optional arguments, at least one of them must be specified. Further, any specified set of free directions cannot include only two rotational degrees of freedom.

  • u2 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the 2-direction as a free direction.

  • u3 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the 3-direction as a free direction.

  • ur1 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the rotation about the 1-direction as a free direction.

  • ur2 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the rotation about the 2-direction as a free direction.

  • ur3 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the rotation about the 3-direction as a free direction.

  • referencePoint (tuple, default: ()) – A sequence of Floats specifying the X, Y and Z-coordinates of a fixed rotation point or a point on the rotation axis or a point on the symmetry line, about which rotations are defined. Such a point must be specified only for certain combinations of free directions.

  • localCoordinates (Optional[int], default: None) – None or a DatumCsys object specifying the local coordinate system of the rigid body degrees of freedom for the inertia relief load. If localCoordinates = None, the free directions are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

Returns:

An InertiaRelief object.

Return type:

InertiaRelief

InwardVolAccel(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET)[source]

This method creates a InwardVolAccel object.

Note

This function can be accessed by:

mdb.models[name].InwardVolAccel

Note

Check InwardVolAccel on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the name of the first analysis step.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

An InwardVolAccel object.

Return type:

InwardVolAccel

LineLoad(name, createStepName, region, distributionType=abaqusConstants.UNIFORM, field='', comp1=None, comp2=None, comp3=None, amplitude=abaqusConstants.UNSET, system=abaqusConstants.GLOBAL)[source]

This method creates a LineLoad object.

Note

This function can be accessed by:

mdb.models[name].LineLoad

Note

Check LineLoad on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • comp1 (Optional[float], default: None) – A Float or a Complex specifying the component of the load in the global or the beam local 1-direction.Note:Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero unless distributionType = USER_DEFINED.

  • comp2 (Optional[float], default: None) – A Float or a Complex specifying the component of the load in the global or the beam local 2-direction.

  • comp3 (Optional[float], default: None) – A Float or a Complex specifying the component of the load in the global 3-direction.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • system (SymbolicConstant, default: GLOBAL) – A SymbolicConstant specifying whether the load is applied in a global or the beam local frame of reference. Possible values are GLOBAL and LOCAL. The default value is GLOBAL.

Returns:

A LineLoad object.

Return type:

LineLoad

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

Moment(name, createStepName, region, cm1=None, cm2=None, cm3=None, amplitude=abaqusConstants.UNSET, follower=OFF, localCsys=None, distributionType=abaqusConstants.UNIFORM, field='')[source]

This method creates a Moment object.

Note

This function can be accessed by:

mdb.models[name].Moment

Note

Check Moment on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • cm1 (Optional[float], default: None) – A Float or a Complex specifying the load component in the 4-direction.Note:Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero.

  • cm2 (Optional[float], default: None) – A Float or a Complex specifying the load component in the 5- direction.

  • cm3 (Optional[float], default: None) – A Float or a Complex specifying the load component in the 6-direction.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • follower (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the direction of the force rotates with the rotation of the node. You should provide the follower argument only if it is valid for the specified step. The default value is OFF.

  • localCsys (Optional[int], default: None) – None or a DatumCsys object specifying the ID of the Datum coordinate system used as the local coordinate system of the load. If localCsys = None, the load is defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

Returns:

A Moment object.

Return type:

Moment

PEGLoad(name, createStepName, region, distributionType=abaqusConstants.UNIFORM, field='', comp1=None, comp2=None, comp3=None, amplitude=abaqusConstants.UNSET)[source]

This method creates a PEGLoad object.

Note

This function can be accessed by:

mdb.models[name].PEGLoad

Note

Check PEGLoad on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • comp1 (Optional[float], default: None) – A Float or a Complex specifying the load component at dof 1 of reference node 1.Note:Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero.

  • comp2 (Optional[float], default: None) – A Float or a Complex specifying the load component at dof 1 of reference node 2.

  • comp3 (Optional[float], default: None) – A Float or a Complex specifying the load component at dof 2 of reference node 2.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A PEGLoad object.

Return type:

PEGLoad

PipePressure(name, createStepName, region, magnitude, diameter, hZero, hReference, field='', amplitude=abaqusConstants.UNSET, distributionType=abaqusConstants.UNIFORM, side=abaqusConstants.INTERNAL)[source]

This method creates a Pressure object.

Note

This function can be accessed by:

mdb.models[name].PipePressure

Note

Check PipePressure on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the pressure is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the pressure magnitude.Note:magnitude is optional if distributionType = USER_DEFINED.

  • diameter (float) – A Float specifying the effective inner or outer diameter.

  • hZero (float) – A Float specifying the height of the zero pressure level when distributionType = HYDROSTATIC.

  • hReference (float) – A Float specifying the height of the reference pressure level when distributionType = HYDROSTATIC.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM, HYDROSTATIC, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • side (SymbolicConstant, default: INTERNAL) – A SymbolicConstant specifying whether the pressure is applied internally or externally. Possible values are INTERNAL and EXTERNAL. The default value is INTERNAL.

Returns:

A PipePressure object.

Return type:

PipePressure

Pressure(name, createStepName, region, magnitude=0.0, hZero=0.0, hReference=0.0, field='', refPoint='', distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET)[source]

This method creates a Pressure object.

Note

This function can be accessed by:

mdb.models[name].Pressure

Note

Check Pressure on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the pressure is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float, default: 0.0) – A Float or a Complex specifying the pressure magnitude.Note:magnitude is optional if distributionType = USER_DEFINED.

  • hZero (float, default: 0.0) – A Float specifying the height of the zero pressure level when distributionType = HYDROSTATIC.

  • hReference (float, default: 0.0) – A Float specifying the height of the reference pressure level when distributionType = HYDROSTATIC.

  • field (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object associated with this load. The field argument applies only when distributionType = FIELD or distributionType = DISCRETE_FIELD. The default value is an empty string.

  • refPoint (str, default: '') – A Region specifying the reference point from which the relative velocity is determined when distributionType = STAGNATION or VISCOUS.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the pressure is distributed spatially. Possible values are UNIFORM, USER_DEFINED, FIELD, HYDROSTATIC, STAGNATION, VISCOUS, TOTAL_FORCE, and DISCRETE_FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A Pressure object.

Return type:

Pressure

RotationalBodyForce(name, createStepName, region, magnitude, point1, point2, distributionType=abaqusConstants.UNIFORM, field='', centrifugal=OFF, rotaryAcceleration=OFF, amplitude=abaqusConstants.UNSET)[source]

This method creates a RotationalBodyForce object.

Note

This function can be accessed by:

mdb.models[name].RotationalBodyForce

Note

Check RotationalBodyForce on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • point1 (tuple) – A sequence of Floats specifying the first point on the axis of rotation for the load.

  • point2 (tuple) – A sequence of Floats specifying the second point on the axis of rotation for the load.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • centrifugal (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not the effect of the load is centrifugal. The default value is OFF.Note:At least one of centrifugal or rotaryAcceleration must be specified and only one must have the value ON.

  • rotaryAcceleration (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not the effect of the load is rotary acceleration. The default value is OFF.Note:At least one of centrifugal or rotaryAcceleration must be specified and only one must have the value ON.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A RotationalBodyForce object.

Return type:

RotationalBodyForce

ShellEdgeLoad(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET, angle=0, axis=abaqusConstants.AXIS_1, localCsys=abaqusConstants.GENERAL, userCsys=abaqusConstants.GENERAL, directionVector=(), follower=ON, resultant=OFF, traction=abaqusConstants.NORMAL)[source]

This method creates a ShellEdgeLoad object.

Note

This function can be accessed by:

mdb.models[name].ShellEdgeLoad

Note

Check ShellEdgeLoad on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float or Complex specifying the load magnitude. magnitude is optional if distributionType = USER_DEFINED

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the shell edge load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • angle (float, default: 0) – A Float specifying an additional rotation of directionVector about an axis. The default value is 0.This parameter is available only if traction is GENERAL.

  • axis (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis about which to apply an additional rotation of directionVector. Possible values are AXIS_1, AXIS_2, AXIS_3. The default value is AXIS_1.This parameter is available only if traction is GENERAL.

  • localCsys (int, default: GENERAL) – A DatumCsys object specifying the local coordinate system of the load’s degrees of freedom. The default value is None, indicating that the degrees of freedom are defined in the global coordinate system or by the userCsys parameter if defined. This parameter is available only if traction is GENERAL. When this member is queried, it returns an Int.

  • userCsys (str, default: GENERAL) – A String specifying a CSYS defined by a user-subroutine. The default value is None, indicating that the degrees of freedom are defined in the global coordinate system or by the localCsys parameter if defined. This parameter is available only if traction is GENERAL.

  • directionVector (tuple, default: ()) – A tuple of two points specifying the direction of the load. Each point is specified as a point region or a tuple of coordinates. If traction is SHEAR, then directionVector will be projected onto the region surface. This parameter is available only if traction is GENERAL.

  • follower (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the direction of the force changes with rotation. The default value is ON. This parameter may be modified only if traction is GENERAL. You should provide the follower argument only if it is valid for the specified step.

  • resultant (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to maintain a constant resultant force by defining traction per unit undeformed area. If resultant is OFF, traction is defined per unit deformed area. The default value is OFF. You should provide the resultant argument only if it is valid for the specified step.

  • traction (SymbolicConstant, default: NORMAL) – A SymbolicConstant specifying how to apply surface traction. Possible values are NORMAL, TRANSVERSE, SHEAR, MOMENT and GENERAL. The default value is NORMAL.

Returns:

A ShellEdgeLoad object.

Return type:

ShellEdgeLoad

SubmodelSB(name, createStepName, region, globalStep, globalDrivingRegion='', absoluteExteriorTolerance=None, exteriorTolerance=0, globalIncrement=0)[source]

This method creates a SubmodelSB object.

Note

This function can be accessed by:

mdb.models[name].SubmodelSB

Note

Check SubmodelSB on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • globalStep (str) – A String specifying the step in the global model from which Abaqus reads the values of the variables that will drive the submodel analysis. The String indicates the position of the step in the sequence of analysis steps. For example, globalStep = ‘1’ indicates the first step.

  • globalDrivingRegion (str, default: '') – A String specifying the element set in the global model that will be searched for elements whose responses will be used to drive the submodel. An empty string indicates that the entire global model will be searched. The default value is an empty string.

  • absoluteExteriorTolerance (Optional[float], default: None) – None or a Float specifying the absolute value by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is None.

  • exteriorTolerance (float, default: 0) – None or a Float specifying the fraction of the average element size in the global model by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is 0.05.

  • globalIncrement (int, default: 0) – An Int specifying the increment number in the global model step from which the solution will be used to specify the values of the driven variables. If globalIncrement = 0, the solution from the last increment will be used. The globalIncrement argument is applicable only for linear perturbation steps. The default value is 0.

Returns:

A SubmodelSB object.

Return type:

SubmodelSB

SubstructureLoad(name, createStepName, region, loadCaseNames, magnitude, amplitude=abaqusConstants.UNSET)[source]

This method creates a SubstructureLoad object.

Note

This function can be accessed by:

mdb.models[name].SubstructureLoad

Note

Check SubstructureLoad on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the substructure load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • loadCaseNames (str) – A list of names of the load cases that should be activated by this substructure load.

  • magnitude (float) – A Float specifying the multiplier for the load case magnitude.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SubstructureLoad object.

Return type:

SubstructureLoad

SurfaceCharge(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET)[source]

This method creates a SurfaceCharge object.

Note

This function can be accessed by:

mdb.models[name].SurfaceCharge

Note

Check SurfaceCharge on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceCharge object.

Return type:

SurfaceCharge

SurfaceConcentrationFlux(name, createStepName, region, magnitude, field='', distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET)[source]

This method creates a SurfaceConcentrationFlux object.

Note

This function can be accessed by:

mdb.models[name].SurfaceConcentrationFlux

Note

Check SurfaceConcentrationFlux on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the surface concentration flux magnitude. magnitude is optional if distributionType = USER_DEFINED.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the surface concentration flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceConcentrationFlux object.

Return type:

SurfaceConcentrationFlux

SurfaceCurrent(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET)[source]

This method creates a SurfaceCurrent object.

Note

This function can be accessed by:

mdb.models[name].SurfaceCurrent

Note

Check SurfaceCurrent on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the load magnitude.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceCurrent object.

Return type:

SurfaceCurrent

SurfaceCurrentDensity(name, createStepName, region, comp1, comp2, comp3, distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET)[source]

This method creates a SurfaceCurrentDensity object.

Note

This function can be accessed by:

mdb.models[name].SurfaceCurrentDensity

Note

Check SurfaceCurrentDensity on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created. This must be the first analysis step name.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • comp1 (str) – A Complex specifying the first component of the load.

  • comp2 (str) – A Complex specifying the second component of the load.

  • comp3 (str) – A Complex specifying the third component of the load.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceCurrentDensity object.

Return type:

SurfaceCurrentDensity

SurfaceHeatFlux(name, createStepName, region, magnitude, field='', distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET)[source]

This method creates a SurfaceHeatFlux object.

Note

This function can be accessed by:

mdb.models[name].SurfaceHeatFlux

Note

Check SurfaceHeatFlux on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the surface heat flux magnitude. magnitude is optional if distributionType = USER_DEFINED.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the surface heat flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceHeatFlux object.

Return type:

SurfaceHeatFlux

SurfacePoreFluid(name, createStepName, region, magnitude, field='', distributionType=abaqusConstants.UNIFORM, amplitude=abaqusConstants.UNSET)[source]

This method creates a SurfacePoreFluid object.

Note

This function can be accessed by:

mdb.models[name].SurfacePoreFluid

Note

Check SurfacePoreFluid on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float specifying the surface pore fluid flow magnitude. magnitude is optional if distributionType = USER_DEFINED.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfacePoreFluid object.

Return type:

SurfacePoreFluid

SurfaceTraction(name, createStepName, region, magnitude, distributionType=abaqusConstants.UNIFORM, field='', amplitude=abaqusConstants.UNSET, angle=0, axis=abaqusConstants.AXIS_1, localCsys=None, userCsys='', directionVector=(), follower=ON, resultant=OFF, traction=abaqusConstants.SHEAR)[source]

This method creates a SurfaceTraction object.

Note

This function can be accessed by:

mdb.models[name].SurfaceTraction

Note

Check SurfaceTraction on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the load repository key.

  • createStepName (str) – A String specifying the name of the step in which the load is created.

  • region (Region) – A Region object specifying the region to which the load is applied.

  • magnitude (float) – A Float or Complex specifying the load magnitude. magnitude is optional if distributionType = USER_DEFINED.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the surface traction is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

  • angle (float, default: 0) – A Float specifying an additional rotation of directionVector about an axis. The default value is 0.0.

  • axis (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis about which to apply an additional rotation of directionVector. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

  • localCsys (Optional[int], default: None) – None or a DatumCsys object specifying the local coordinate system of the load’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system or by the userCsys parameter if defined. When this member is queried, it returns an Int. The default value is None.

  • userCsys (str, default: '') – A String specifying a CSYS defined by a user-subroutine. If userCsys = None, the degrees of freedom are defined in the global coordinate system or by the localCsys parameter if defined. The default value is “None”.

  • directionVector (tuple, default: ()) – A VertexArray object of length 2 specifying the direction of the load. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. If traction is SHEAR, then directionVector will be projected onto the region surface. This parameter is available only if traction is GENERAL or SHEAR.

  • follower (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the direction of the force changes with rotation. The default value is ON.This parameter may be modified only if traction is GENERAL. You should provide the follower argument only if it is valid for the specified step.

  • resultant (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the to maintain a constant resultant force by defining traction per unit undeformed area. If resultant is OFF, traction is defined per unit deformed area. The default value is OFF.You should provide the resultant argument only if it is valid for the specified step.

  • traction (SymbolicConstant, default: SHEAR) – A SymbolicConstant specifying how to apply surface traction. Possible values are SHEAR and GENERAL. The default value is SHEAR.

Returns:

A SurfaceTraction object.

Return type:

SurfaceTraction

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

MaterialModel#

class MaterialModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check MaterialModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

Material(name[, description, materialIdentifier])

This method creates a Material object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
Material(name, description='', materialIdentifier='')[source]

This method creates a Material object.

Note

This function can be accessed by:

mdb.models[name].Material

Note

Check Material on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the name of the new material.

  • description (str, default: '') – A String specifying user description of the material. The default value is an empty string.

  • materialIdentifier (str, default: '') – A String specifying material identifier for customer use. The default value is an empty string.

Returns:

A Material object.

Return type:

Material

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

OptimizationTaskModel#

class OptimizationTaskModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check OptimizationTaskModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

BeadTask(name[, abaqusSensitivities, ...])

This method creates a BeadTask object.

ShapeTask(name[, abaqusSensitivities, ...])

This method creates a ShapeTask object.

SizingTask(name[, abaqusSensitivities, ...])

This method creates a SizingTask object.

TopologyTask(name[, abaqusSensitivities, ...])

This method creates a TopologyTask object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
BeadTask(name, abaqusSensitivities=True, algorithm=abaqusConstants.GENERAL_OPTIMIZATION, areBCRegionsFrozen=OFF, beadIter=1, beadMaxMembraneStress=0, beadMinStress=0, beadPerturbation=0, beadWidth=abaqusConstants.DEFAULT, curveSmooth=5, filterRadius=4, filterRadiusBy=abaqusConstants.VALUE, flipNormalDir=OFF, frozenBoundaryConditionRegion=abaqusConstants.MODEL, isSensCalcOnlyOnDesignNodes=OFF, modeTrackingRegion=abaqusConstants.MODEL, nodalMoveLimit=0, nodeSmooth=abaqusConstants.DEFAULT, nodeUpdateStrategy=abaqusConstants.CONSERVATIVE, numTrackedModes=5, updateShapeBasisVectors=abaqusConstants.EVERY_CYCLE)[source]

This method creates a BeadTask object.

Note

This function can be accessed by:

mdb.models[name].BeadTask

Note

Check BeadTask on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the optimization task repository key.

  • abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –

    A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

    New in version 2019: The abaqusSensitivities argument was added.

  • algorithm (SymbolicConstant, default: GENERAL_OPTIMIZATION) – A SymbolicConstant specifying the optimization task algorithm. Possible values are GENERAL_OPTIMIZATION and CONDITION_BASED_OPTIMIZATION. The default value is GENERAL_OPTIMIZATION.

  • areBCRegionsFrozen (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

  • beadIter (str, default: 1) – An int specifying the step size of the optimization. The default value is 1.

  • beadMaxMembraneStress (str, default: 0) – A float specifying maximum membrane/bending stress. The default value is 0.1.

  • beadMinStress (str, default: 0) – A float specifying minimum stress. The default value is 0.001.

  • beadPerturbation (str, default: 0) – A Sets perturbation size for finite differences. The default value is 0.0001.

  • beadWidth (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the Optimization product default or a float specifying the bead width. The default value is DEFAULT.

  • curveSmooth (str, default: 5) – A float specifying relative value to the middle element edge length such that normals in this area do not cross each other. The default value is 5.

  • filterRadius (str, default: 4) – A float specifying the filter radius. The default value is 4.

  • filterRadiusBy (SymbolicConstant, default: VALUE) – A SymbolicConstant specifying the method used to define filter radius. Possible values are VALUE and REFERENCE. The default is VALUE.

  • flipNormalDir (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the growth direction is along the normal direction of elements or opposite to the normal direction. The default value is OFF

  • frozenBoundaryConditionRegion (SymbolicConstant, default: MODEL) – When nodes with boundary conditions are excluded from the optimization (frozenBoundaryConditionRegions = ON). you can specify that this exclusion apply to nodes throughout the model or only to those nodes from a specific region. Set this parameter to the SymbolicConstant MODEL to apply the freeze to the entire model, or set this parameter to a Region object to specify an individual region over which nodes with boundary conditions should be frozen. The default value is MODEL.

  • isSensCalcOnlyOnDesignNodes (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to calculate the sensitivities only on design nodes or the whole model. The default value is ON

  • modeTrackingRegion (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

  • nodalMoveLimit (float, default: 0) – A Float specifying the maximum change in nodal displacement per design cycle. The default value is 0.1.

  • nodeSmooth (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the Optimization product default or a float specifying the node smooth. The default value is DEFAULT.

  • nodeUpdateStrategy (SymbolicConstant, default: CONSERVATIVE) – A SymbolicConstant specifying the strategy for how the nodal displacements are updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is CONSERVATIVE.

  • numTrackedModes (int, default: 5) – An Int specifying the number of modes included in mode tracking. The default value is 5.

  • updateShapeBasisVectors (SymbolicConstant, default: EVERY_CYCLE) – A SymbolicConstant specifying whether to update shape basis vectors in the first design cycle or every design cycle. Possible values are EVERY_CYCLE and FIRST_CYCLE. The default value is EVERY_CYCLE.

Returns:

A BeadTask object.

Return type:

BeadTask

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ShapeTask(name, abaqusSensitivities=True, absoluteStepSizeControl=abaqusConstants.MINIMUM, activateDurability=ON, additionalDurabilityFiles='', constrainedLaplacianConvergenceLevel=abaqusConstants.NORMAL, curvatureSmoothingEdgeLength=5, durabilityInputfile='', durabilitySolver=abaqusConstants.FE_SAFE, equalityConstraintTolerance=None, featureRecognitionAngle=30, filterExponent=1, filterMaxRadius=None, filterRadiusReduction=None, firstCycleDeletedVolumeTechnique=OFF, freezeBoundaryConditionRegions=OFF, frozenBoundaryConditionRegion=abaqusConstants.MODEL, geometricRestrictionEvaluationFrequency=abaqusConstants.LOW, growthScaleFactor=1, haltUponViolation=OFF, layerReferenceRegion=None, meshSmoothingRegionMethod=abaqusConstants.TASK_REGION_LAYERS, meshSmoothingStrategy=abaqusConstants.CONSTRAINED_LAPLACIAN, midsideInterpolation=abaqusConstants.POSITIONS, numFreeNodeLayers=0, numSmoothedElementLayers=None, presumeFeasibleBCRegionAtStart=ON, quadMaxAngle=160, quadMinAngle=20, quadSkew=30, quadTaper=0, region=abaqusConstants.MODEL, reportPoorQualityElements=OFF, reportQualityViolation=OFF, shrinkScaleFactor=1, smoothingRegion=None, targetMeshQuality=abaqusConstants.LOW, tetAspectRatio=100, tetMaxAspect=8, tetMinAspect=0, tetSkew=100, triMaxAngle=140, triMinAngle=20, updateShapeBasisVectors=abaqusConstants.EVERY_CYCLE)[source]

This method creates a ShapeTask object.

Note

This function can be accessed by:

mdb.models[name].ShapeTask

Note

Check ShapeTask on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the optimization task repository key.

  • abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –

    A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

    New in version 2019: The abaqusSensitivities argument was added.

  • absoluteStepSizeControl (SymbolicConstant, default: MINIMUM) – A SymbolicConstant specifying whether to control the permitted absolute step size by the average optimization displacement or minimum optimization displacement. Possible values are MINIMUM and AVERAGE. The default value is MINIMUM.

  • activateDurability (Union[AbaqusBoolean, bool], default: ON) – A boolean specifying whether or not the durability approach of optimization is turned on. The default value is ON.

  • additionalDurabilityFiles (str, default: '') – A String specifying the path of additional files pertaining to durability optimization. Only valid if the activateDurability argument is ON.

  • constrainedLaplacianConvergenceLevel (SymbolicConstant, default: NORMAL) – A SymbolicConstant specifying the constrained Laplacian convergence level. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

  • curvatureSmoothingEdgeLength (float, default: 5) – A Float specifying the edge length for the movement vector. The default value is 5.0.

  • durabilityInputfile (str, default: '') – A string specifying the path of the input file. Only valid if the activateDurability argument is ON and is a required argument in that case.

  • durabilitySolver (str, default: FE_SAFE) – A String specifying the type of solver for durability optimization. Possible values are: FE_SAFE, FEMFAT, FLANS, MSC_FATIGUE, FE_FATIGUE, DESIGN_LIFE, CUSTOM, FEMSITE. The default value is FE_SAFE. Only valid if the activateDurability argument is ON.

  • equalityConstraintTolerance (Optional[float], default: None) – A Float specifying the equality constraint tolerance. The default value is 10-3.

  • featureRecognitionAngle (float, default: 30) – A Float specifying the mesh smoothing feature recognition angle for edges and corners. The default value is 30.0.

  • filterExponent (float, default: 1) – A Float specifying the weight depending on the radius, used when filterMaxRadius is specified. The default value is 1.0.

  • filterMaxRadius (Optional[float], default: None) – None or a Float specifying the maximum influence radius for equivalent stress. The default value is None.

  • filterRadiusReduction (Optional[float], default: None) – None or a Float specifying the reduction of the radius depending on surface bending, used when filterMaxRadius is specified. The default value is None.

  • firstCycleDeletedVolumeTechnique (SymbolicConstant, default: OFF) – A SymbolicConstant specifying the method of specifying volume that can be removed immediately in the first design cycle. Possible values are OFF, PERCENTAGE, and ABSOLUTE. The default value is OFF.

  • freezeBoundaryConditionRegions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude nodes with boundary conditions from the optimization. The default value is OFF.

  • frozenBoundaryConditionRegion (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region in which to freeze boundary condition regions, or the SymbolicConstant MODEL, used with freezeBoundaryConditionRegions. The default value is MODEL.

  • geometricRestrictionEvaluationFrequency (SymbolicConstant, default: LOW) – A SymbolicConstant specifying the frequency of evaluating geometric restrictions during mesh smoothing. Possible values are LOW, MEDIUM, and HIGH. The default value is LOW.

  • growthScaleFactor (float, default: 1) – A Float specifying the scale factor to apply to optimization displacements for nodes with growth. The default value is 1.0.

  • haltUponViolation (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to halt the optimization if quality criteria are not satisified. The default value is OFF.

  • layerReferenceRegion (Optional[str], default: None) – None or a Region object specifying the region specifying the first node layer for mesh smoothing, used when meshSmoothingRegionMethod is TASK_REGION_LAYERS. The default value is None.

  • meshSmoothingRegionMethod (SymbolicConstant, default: TASK_REGION_LAYERS) – A SymbolicConstant specifying the method used to determine the mesh smoothing region. The REGION value uses the smoothingRegion. The NUMBER_OF_LAYERS value uses the layerReferenceRegion. The TASK_REGION_LAYERS value will smooth six layers using the task region. Possible values are TASK_REGION_LAYERS, REGION, and NUMBER_OF_LAYERS. The default value is TASK_REGION_LAYERS.

  • meshSmoothingStrategy (SymbolicConstant, default: CONSTRAINED_LAPLACIAN) – A SymbolicConstant specifying the method smoothing strategy. Possible values are CONSTRAINED_LAPLACIAN and LOCAL_GRADIENT. The default value is CONSTRAINED_LAPLACIAN.

  • midsideInterpolation (SymbolicConstant, default: POSITIONS) – A SymbolicConstant specifying the approach used when treating midside node positions during optimization. POSITIONS indicates midside node positions are interpolated linearly by position. OPTIMIZATION_DISPLACEMENT indicates they are interpolated by optimization displacement of corner nodes. Possible values are POSITIONS and OPTIMIZATION_DISPLACEMENT. The default value is POSITIONS.

  • numFreeNodeLayers (SymbolicConstant, default: 0) – The SymbolicConstant FIX_NONE or an Int specifying the number of node layers adjoining the task region to remain free during mesh smoothing. A value of 0 indicates that no layers are free and all layers are fixed. The default value is 0.

  • numSmoothedElementLayers (Optional[int], default: None) – None or an Int specifying the number of layers for mesh smoothing when meshSmoothingRegionMethod is NUMBER_OF_LAYERS. The default value is None.

  • presumeFeasibleBCRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore automatically frozen boundary condition regions in the first design cycle. This is used with freezeBoundaryConditionRegions. The default value is ON.

  • quadMaxAngle (float, default: 160) – A Float specifying the maximum angle for quad elements during mesh smoothing. The default value is 160.0.

  • quadMinAngle (float, default: 20) – A Float specifying the minimum angle for quad elements during mesh smoothing. The default value is 20.0.

  • quadSkew (float, default: 30) – A Float specifying the skew angle for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 30.0.

  • quadTaper (float, default: 0) – A Float specifying the taper for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 0.5.

  • region (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.

  • reportPoorQualityElements (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to report poor quality elements during mesh smoothing. The default value is OFF.

  • reportQualityViolation (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to report a quality criteria violation during mesh smoothing. The default value is OFF.

  • shrinkScaleFactor (float, default: 1) – A Float specifying the scale factor to apply to optimization displacements for nodes with shrinkage. The default value is 1.0.

  • smoothingRegion (Optional[str], default: None) – None or a Region object specifying the mesh smoothing region, used when meshSmoothingRegionMethod is REGION. The default value is None.

  • targetMeshQuality (SymbolicConstant, default: LOW) – A SymbolicConstant specifying the target mesh quality for mesh smoothing. Possible values are NONE, LOW, MEDIUM, and HIGH. The default value is LOW.

  • tetAspectRatio (float, default: 100) – A Float specifying the tet element aspect ratio during mesh smoothing. The default value is 100.0.

  • tetMaxAspect (float, default: 8) – A Float specifying the maximum tet element aspect ratio during mesh smoothing. The default value is 8.0.

  • tetMinAspect (float, default: 0) – A Float specifying the minimum tet element aspect ratio during mesh smoothing. The default value is 0.222.

  • tetSkew (float, default: 100) – A Float specifying the tet element skew value during mesh smoothing. The default value is 100.0.

  • triMaxAngle (float, default: 140) – A Float specifying the tri element maximum angle during mesh smoothing. The default value is 140.0.

  • triMinAngle (float, default: 20) – A Float specifying the tri element maximum angle during mesh smoothing. The default value is 20.0.

  • updateShapeBasisVectors (SymbolicConstant, default: EVERY_CYCLE) – A SymbolicConstant specifying whether to update shape basis vectors in the first design cycle or every design cycle. Possible values are EVERY_CYCLE and FIRST_CYCLE. The default value is EVERY_CYCLE.

Returns:

A ShapeTask object.

Return type:

ShapeTask

SizingTask(name, abaqusSensitivities=True, elementThicknessDeltaStopCriteria=0, freezeBoundaryConditionRegions=OFF, freezeLoadRegions=ON, modeTrackingRegion=abaqusConstants.MODEL, numFulfilledStopCriteria=2, numTrackedModes=5, objectiveFunctionDeltaStopCriteria=0, stopCriteriaDesignCycle=4, thicknessMoveLimit=0, thicknessUpdateStrategy=abaqusConstants.NORMAL)[source]

This method creates a SizingTask object.

Note

This function can be accessed by:

mdb.models[name].SizingTask

Note

Check SizingTask on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the optimization task repository key.

  • abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –

    A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

    New in version 2019: The abaqusSensitivities argument was added.

  • elementThicknessDeltaStopCriteria (float, default: 0) – A Float specifying the stop criteria based on the change in element thickness. The default value is 0.5 × 10-2.

  • freezeBoundaryConditionRegions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

  • freezeLoadRegions (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.

  • modeTrackingRegion (str, default: MODEL) – The SymbolicConstatnt MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

  • numFulfilledStopCriteria (int, default: 2) – An Int specifying the number of stop criteria. The default value is 2.

  • numTrackedModes (int, default: 5) – An Int specifying the number of modes included in mode tracking. The default value is 5.

  • objectiveFunctionDeltaStopCriteria (float, default: 0) – A Float specifying the stop criteria based on the change in objective function. The default value is 0.001.

  • stopCriteriaDesignCycle (int, default: 4) – An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.

  • thicknessMoveLimit (float, default: 0) – A Float specifying the maximum change in thickness per design cycle. The default value is 0.25.

  • thicknessUpdateStrategy (SymbolicConstant, default: NORMAL) – A SymbolicConstant specifying the strategy for how the thickness is updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

Returns:

A SizingTask object.

Return type:

SizingTask

TopologyTask(name, abaqusSensitivities=True, algorithm=abaqusConstants.GENERAL_OPTIMIZATION, densityMoveLimit=0, densityUpdateStrategy=abaqusConstants.NORMAL, elementDensityDeltaStopCriteria=0, filterRadius=None, firstCycleDeletedVolume=5, firstCycleDeletedVolumeTechnique=OFF, freezeBoundaryConditionRegions=OFF, freezeLoadRegions=ON, frequencySpectrumWeight=6, initialDensity=abaqusConstants.DEFAULT, materialInterpolationPenalty=3, materialInterpolationTechnique=abaqusConstants.DEFAULT, maxDensity=1, minDensity=None, modeTrackingRegion=abaqusConstants.MODEL, numDesignCycles=15, numFulfilledStopCriteria=2, numTrackedModes=5, objectiveFunctionDeltaStopCriteria=None, region=abaqusConstants.MODEL, softDeletionMethod=abaqusConstants.STANDARD, softDeletionRadius=0, softDeletionRegion=None, softDeletionThreshold=None, stepSize=abaqusConstants.MEDIUM, stiffnessMassDamping=abaqusConstants.AVERAGE_EDGE_LENGTH, stopCriteriaDesignCycle=4, structuralMassDamping=None, viscousMassDamping=None, viscousStiffnessDamping=None)[source]

This method creates a TopologyTask object.

Note

This function can be accessed by:

mdb.models[name].TopologyTask

Note

Check TopologyTask on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the optimization task repository key.

  • abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –

    A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

    New in version 2019: The abaqusSensitivities argument was added.

  • algorithm (SymbolicConstant, default: GENERAL_OPTIMIZATION) – A SymbolicConstant specifying the optimization task algorithm. Possible values are GENERAL_OPTIMIZATION and CONDITION_BASED_OPTIMIZATION. The default value is GENERAL_OPTIMIZATION.

  • densityMoveLimit (float, default: 0) – A Float specifying the maximum density change per design cycle. The default value is 0.25.

  • densityUpdateStrategy (SymbolicConstant, default: NORMAL) – A SymbolicConstant specifying the strategy for how the densities are updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

  • elementDensityDeltaStopCriteria (float, default: 0) – A Float specifying the stop criteria based upon the change in element densities. The default value is 0.5×10-2.

  • filterRadius (Optional[float], default: None) – None or a Float specifying the mesh filter radius for mesh independence and minimum size. The default value is None.

  • firstCycleDeletedVolume (float, default: 5) – A Float specifying the volume that can be removed immediately in the first design cycle. The default value is 5.0.

  • firstCycleDeletedVolumeTechnique (SymbolicConstant, default: OFF) – A SymbolicConstant specifying the method of quantifying volume that can be removed immediately in the first design cycle. Possible values are OFF, PERCENTAGE, and ABSOLUTE. The default value is OFF.

  • freezeBoundaryConditionRegions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

  • freezeLoadRegions (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.

  • frequencySpectrumWeight (float, default: 6) – A Float specifying the weighting factor for frequency spectrum peaks. The default value is 6.0.

  • initialDensity (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the Optimization product default or a float specifying the initial density. The default value is DEFAULT.

  • materialInterpolationPenalty (float, default: 3) – A Float specifying the penalty factor for the material interpolation technique. The default value is 3.0.

  • materialInterpolationTechnique (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the material interpolation technique: optimization product default, solid isotropic material with penalization, or rational approximation of material properties. Possible values are DEFAULT, SIMP, and RAMP. The default value is DEFAULT.

  • maxDensity (float, default: 1) – A Float specifying the maximum density in the density update. The default value is 1.0.

  • minDensity (Optional[float], default: None) – A Float specifying the minimum density in the density update. The default value is 10-3.

  • modeTrackingRegion (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

  • numDesignCycles (int, default: 15) – An Int specifying the number of design cycles permitted when stepSize is DYNAMIC. The default value is 15.

  • numFulfilledStopCriteria (int, default: 2) – An Int specifying the number of stop criteria. The default value is 2.

  • numTrackedModes (int, default: 5) – An Int specifying the number of modes included in mode tracking. The default value is 5.

  • objectiveFunctionDeltaStopCriteria (Optional[float], default: None) – A Float specifying the stop criteria based on the change in objective function. The default value is 10-3.

  • region (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.

  • softDeletionMethod (SymbolicConstant, default: STANDARD) – A SymbolicConstant specifying the method used when softDeletionRegion is specified. The STANDARD method avoids creating disconnected regions. The AGGRESSIVE method only considers the softDeletionThreshold. The MAX_SHEAR_STRAIN, MAX_ELASTOPLASTIC_STRAIN and VOLUME_COMPRESSION methods do not need the softDeletionRadius. Possible values are STANDARD, AGGRESSIVE, MAX_SHEAR_STRAIN, MIN_PRINCIPAL_STRAIN, MAX_ELASTOPLASTIC_STRAIN and VOLUME_COMPRESSION. The default value is STANDARD.

  • softDeletionRadius (float, default: 0) – A Float specifying the radius to use when considering neighboring soft elements to delete. The default value is 0.0.

  • softDeletionRegion (Optional[str], default: None) – None or a Region object specifying the region in which the soft elements should be deleted during optimization. The default value is None.

  • softDeletionThreshold (Optional[float], default: None) – A Float specifying the relative material density value used to identify soft elements. Those with values below the threshold are considered for removal. For STANDARD and AGGRESSIVE methods positive values are accepted and the default value is 0.05. For MAX_SHEAR_STRAIN and MAX_ELASTOPLASTIC_STRAIN methods positive values are accepted whereas for MIN_PRINCIPAL_STRAIN and VOLUME_COMPRESSION methods negative values are accepted.

  • stepSize (SymbolicConstant, default: MEDIUM) – A SymbolicConstant specifying the size of the increment for volume modification. Possible values are DYNAMIC, VERY_SMALL, SMALL, MODERATE, MEDIUM, and LARGE. The default value is MEDIUM.

  • stiffnessMassDamping (Union[SymbolicConstant, float], default: AVERAGE_EDGE_LENGTH) – The SymbolicConstant AVERAGE_EDGE_LENGTH or a Float specifying the stiffness mass damping for the task region. The default value is AVERAGE_EDGE_LENGTH.

  • stopCriteriaDesignCycle (int, default: 4) – An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.

  • structuralMassDamping (Optional[float], default: None) – None or a Float specifying the structural mass damping for the task region. The default value is None.

  • viscousMassDamping (Optional[float], default: None) – None or a Float specifying the viscous mass damping for the task region. The default value is None.

  • viscousStiffnessDamping (Optional[float], default: None) – None or a Float specifying the viscous stiffness damping for the task region. The default value is None.

Returns:

A TopologyTask object.

Return type:

TopologyTask

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

PartModel#

class PartModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check PartModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

Part(name, dimensionality, type[, twist])

This method creates a Part object and places it in the parts repository.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

Part(name, dimensionality, type, twist=OFF)[source]

This method creates a Part object and places it in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part

Note

Check Part on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • dimensionality (Literal[THREE_D, TWO_D_PLANAR, AXISYMMETRIC]) – A SymbolicConstant specifying the dimensionality of the part. Possible values are THREE_D, TWO_D_PLANAR, and AXISYMMETRIC.

  • type (Literal[DEFORMABLE_BODY, EULERIAN, DISCRETE_RIGID_SURFACE, ANALYTIC_RIGID_SURFACE]) – A SymbolicConstant specifying the type of the part. Possible values are DEFORMABLE_BODY, EULERIAN, DISCRETE_RIGID_SURFACE, and ANALYTIC_RIGID_SURFACE.

  • twist (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include a twist DEGREE OF FREEDOM in the part (only available when dimensionality = AXISYMMETRIC and type = DEFORMABLE_BODY). The default value is OFF.

Returns:

A Part object.

Return type:

Part

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

PredefinedFieldModel#

class PredefinedFieldModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check PredefinedFieldModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

FluidCavityPressure(name, fluidCavity, ...)

This method creates a FluidCavityPressure object.

InitialState(name, instances, fileName[, ...])

This method creates an InitialState predefined field object.

KinematicHardening(name, region[, ...])

This method creates a KinematicHardening object.

MaterialAssignment(name, instanceList[, ...])

This method creates a MaterialAssignment predefined field object.

Temperature(name, createStepName, region[, ...])

This method creates a Temperature object.

Velocity(name, region, velocity1, velocity2, ...)

This method creates a Velocity predefined field object.

Stress(name, region[, distributionType, ...])

This method creates a Stress predefined field object.

Field(name, createStepName, region[, ...])

This method creates a Field object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
Field(name, createStepName, region, outputVariable='', fieldVariableNum=None, distributionType=abaqusConstants.UNIFORM, crossSectionDistribution=abaqusConstants.CONSTANT_THROUGH_THICKNESS, field='', amplitude=abaqusConstants.UNSET, fileName='', beginStep=None, beginIncrement=None, endStep=None, endIncrement=None, interpolate=OFF, magnitudes='')[source]

This method creates a Field object.

Note

This function can be accessed by:

mdb.models[name].Field

New in version 2018: The Field method was added.

Note

Check Field on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the predefined field is created.

  • region (Region) – A Region object specifying the region to which the predefined field is applied. Region is ignored if the predefined field has a distributionType member available, and distributionType = FROM_FILE.

  • outputVariable (str, default: '') – A String specifying the scalar nodal output variable that will be read from an output database and used to initialize a specified predefined field. This argument is a required argument if distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.

  • fieldVariableNum (Optional[int], default: None) – An Int specifying the field variable number.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the predefined field varies spatially. Possible values are UNIFORM, USER_DEFINED, FROM_FILE, FIELD, FROM_FILE_AND_USER_DEFINED, and DISCRETE_FIELD. The default value is UNIFORM.

  • crossSectionDistribution (SymbolicConstant, default: CONSTANT_THROUGH_THICKNESS) –

    A SymbolicConstant specifying how the predefined field is distributed over the cross-section of the region. Possible values are

    • CONSTANT_THROUGH_THICKNESS

    • GRADIENTS_THROUGH_SHELL_CS

    • GRADIENTS_THROUGH_BEAM_CS

    • POINTS_THROUGH_SECTION

    The default value is CONSTANT_THROUGH_THICKNESS.

  • field (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object associated with this predefined field. The field argument applies only when distributionType = FIELD or distributionType = DISCRETE_FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) –

    A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the predefined field has no amplitude reference. The default value is UNSET.

    Note

    amplitude should be given only if it is valid for the specified step.

  • fileName (str, default: '') – A String specifying the name of the file from which the Field values are to be read when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.

  • beginStep (Optional[SymbolicConstant], default: None) – An Int specifying the first step from which Field values are to be read or the SymbolicConstant FIRST_STEP or LAST_STEP. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • beginIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the first increment of the step set in beginStep or the SymbolicConstants STEP_START or STEP_END. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • endStep (Optional[SymbolicConstant], default: None) – An Int specifying the last step from which Field values are to be read or the SymbolicConstants FIRST_STEP and LAST_STEP. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • endIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the last increment of the step set in endStep or the SymbolicConstants STEP_START and STEP_END. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • interpolate (SymbolicConstant, default: OFF) – A SymbolicConstant specifying whether to interpolate a field read from an output database or results file. Possible values are OFF, ON, or MIDSIDE_ONLY. The default value is OFF.

  • magnitudes (str, default: '') –

    A Sequence of Doubles specifying the Field values when distributionType = UNIFORM or FIELD. The value of the magnitudes argument is a function of the crossSectionDistribution argument, as shown in the following list:

    • If crossSectionDistribution = CONSTANT_THROUGH_THICKNESS, magnitudes is a Double specifying the Field.

    • If crossSectionDistribution = GRADIENTS_THROUGH_SHELL_CS, magnitudes is a sequence of Doubles specifying the mean value and the gradient in the thickness direction.

    • If crossSectionDistribution = GRADIENTS_THROUGH_BEAM_CS, magnitudes is a sequence of Doubles specifying the mean value, the gradient in the N1 direction, and the gradient in the N2 direction.

    • If crossSectionDistribution = POINTS_THROUGH_SECTION, magnitudes is a sequence of Doubles specifying the Field at each point.

Return type:

A Field object.

FluidCavityPressure(name, fluidCavity, fluidPressure)[source]

This method creates a FluidCavityPressure object.

Note

This function can be accessed by:

mdb.models[name].FluidCavityPressure

Note

Check FluidCavityPressure on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • fluidCavity (str) – A String specifying the name of a Fluid Cavity Interaction.

  • fluidPressure (float) – A Float specifying the initial fluid pressure.

Returns:

A FluidCavityPressure object.

Return type:

FluidCavityPressure

InitialState(name, instances, fileName, endStep=abaqusConstants.LAST_STEP, endIncrement=abaqusConstants.STEP_END, updateReferenceConfiguration=OFF)[source]

This method creates an InitialState predefined field object.

Note

This function can be accessed by:

mdb.models[name].InitialState

Note

Check InitialState on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • instances (List[PartInstance]) – A PartInstanceArray object specifying the instances to which the predefined field is applied.

  • fileName (str) – A String specifying the name of the job that generated the initial state data.

  • endStep (SymbolicConstant, default: LAST_STEP) – The SymbolicConstant LAST_STEP or an Int specifying the step from which the initial state values are to be read or the SymbolicConstant LAST_STEP. The default value is LAST_STEP.

  • endIncrement (SymbolicConstant, default: STEP_END) – The SymbolicConstant STEP_END or an Int specifying the increment, interval or iteration of the step set in endStep or the SymbolicConstant STEP_END. The default value is STEP_END.

  • updateReferenceConfiguration (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to update the reference configuration based on the import data. The default value is OFF.

Returns:

An InitialState object.

Return type:

InitialState

KinematicHardening(name, region, numBackStress=1, equivPlasticStrain=(), backStress=(), sectPtNum=(), definition=abaqusConstants.KINEMATIC_HARDENING, rebarLayerNames=(), distributionType=abaqusConstants.MAGNITUDE)[source]

This method creates a KinematicHardening object.

Note

This function can be accessed by:

mdb.models[name].KinematicHardening

Note

Check KinematicHardening on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • region (Region) – A Region object specifying the region to which the predefined field is applied.

  • numBackStress (int, default: 1) – An Int specifying the number of backstresses. The default value is 1.

  • equivPlasticStrain (tuple, default: ()) – A sequence of Floats specifying the initial equivalent Plastic strain.

  • backStress (tuple, default: ()) – A sequence of sequences of Floats specifying the initial backstress tensor for kinematic hardening models. The default value is an empty sequence.

  • sectPtNum (tuple, default: ()) – A sequence of Ints specifying section point numbers. This argument is valid only when definition = SECTION_PTS.

  • definition (SymbolicConstant, default: KINEMATIC_HARDENING) – A SymbolicConstant specifying different types of kinematic hardening. Possible values are KINEMATIC_HARDENING, CRUSHABLE_FOAM, REBAR, SECTION_PTS, and USER_DEFINED. The default value is KINEMATIC_HARDENING.

  • rebarLayerNames (tuple, default: ()) – A sequence of Strings specifying rebar layer names. This argument is valid only when definition = REBAR.

  • distributionType (SymbolicConstant, default: MAGNITUDE) – A SymbolicConstant specifying whether the load is uniform. Possible values are MAGNITUDE and ANALYTICAL_FIELD. The default value is MAGNITUDE.

Returns:

A KinematicHardening object.

Return type:

KinematicHardening

MaterialAssignment(name, instanceList, useFields=OFF, assignmentList=(), fieldList=(), colorList=())[source]

This method creates a MaterialAssignment predefined field object.

Note

This function can be accessed by:

mdb.models[name].MaterialAssignment

Note

Check MaterialAssignment on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • instanceList (List[PartInstance]) – A PartInstanceArray object specifying the part instances to which the predefined field is applied. All instances must be assigned the same Eulerian section.

  • useFields (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the volume fraction data will be uniform or defined by discrete fields. The default value is OFF.

  • assignmentList (tuple, default: ()) – A sequence of tuples specifying the uniform volume fractions to be assigned. This argument is valid only when useFields = FALSE. Each tuple contains two entries:A Region object.A tuple of Floats specifying the uniform volume fraction values. The length of the tuple must match the number of material instance names specified in the Eulerain section assigned to part instances specified by instanceList.

  • fieldList (tuple, default: ()) – A sequence of tuples specifying the discrete volume fractions to be assigned. This argument is valid only when useFields = TRUE. Each tuple contains two entries:A Region object.A tuple of Strings specifying Discrete Field names. The length of the tuple must match the number of material instance names specified in the Eulerain section assigned to part instances specified by instanceList.

  • colorList (tuple, default: ()) – A sequence of three Ints specifying colors used to display the material instance assignments. This is a sequence of R,G,B colors, where the values are represented by integers between 0 and 255. The default value is an empty sequence.

Returns:

A MaterialAssignment object.

Return type:

MaterialAssignment

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

Stress(name, region, distributionType=abaqusConstants.UNIFORM, sigma11=None, sigma22=None, sigma33=None, sigma12=None, sigma13=None, sigma23=None)[source]

This method creates a Stress predefined field object.

Note

This function can be accessed by:

mdb.models[name].Stress

New in version 2017: The Stress method was added.

Note

Check Stress on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • region (Region) – A Region object specifying the region to which the predefined field is applied. Region is ignored if the predefined field has distributionType = FROM_FILE.

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM and FROM_FILE. The default value is UNIFORM.

  • sigma11 (Optional[float], default: None) – A Float specifying the first principal component of the stress.

  • sigma22 (Optional[float], default: None) – A Float specifying the second principal component of the stress.

  • sigma33 (Optional[float], default: None) – A Float specifying the third principal component of the stress.

  • sigma12 (Optional[float], default: None) – A Float specifying the first shear component of the stress.

  • sigma13 (Optional[float], default: None) – A Float specifying the second shear component of the stress.

  • sigma23 (Optional[float], default: None) – A Float specifying the third shear component of the stress.

Return type:

A Stress object.

Temperature(name, createStepName, region, distributionType=abaqusConstants.UNIFORM, crossSectionDistribution=abaqusConstants.CONSTANT_THROUGH_THICKNESS, field='', amplitude=abaqusConstants.UNSET, fileName='', beginStep=None, beginIncrement=None, endStep=None, endIncrement=None, interpolate=OFF, magnitudes='', absoluteExteriorTolerance=0, exteriorTolerance=0)[source]

This method creates a Temperature object.

Note

This function can be accessed by:

mdb.models[name].Temperature

Note

Check Temperature on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the predefined field is created.

  • region (Region) – A Region object specifying the region to which the predefined field is applied. Region is ignored if the predefined field has a distributionType member available, and distributionType = FROM_FILE .

  • distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying how the predefined field varies spatially. Possible values are UNIFORM, USER_DEFINED, FROM_FILE, FIELD, FROM_FILE_AND_USER_DEFINED, and DISCRETE_FIELD. The default value is UNIFORM.

  • crossSectionDistribution (SymbolicConstant, default: CONSTANT_THROUGH_THICKNESS) –

    A SymbolicConstant specifying how the predefined field is distributed over the cross section of the region. Possible values are

    • CONSTANT_THROUGH_THICKNESS

    • GRADIENTS_THROUGH_SHELL_CS

    • GRADIENTS_THROUGH_BEAM_CS

    • POINTS_THROUGH_SECTION

    The default value is CONSTANT_THROUGH_THICKNESS.

  • field (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object associated with this predefined field. The field argument applies only when distributionType = FIELD or distributionType = DISCRETE_FIELD. The default value is an empty string.

  • amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the predefined field has no amplitude reference. The default value is UNSET.Note:amplitude should be given only if it is valid for the specified step.

  • fileName (str, default: '') – A String specifying the name of the file from which the temperature values are to be read when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.

  • beginStep (Optional[SymbolicConstant], default: None) – An Int specifying the first step from which temperature values are to be read or the SymbolicConstant FIRST_STEP or LAST_STEP. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • beginIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the first increment of the step set in beginStep or the SymbolicConstants STEP_START or STEP_END. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • endStep (Optional[SymbolicConstant], default: None) – An Int specifying the last step from which temperature values are to be read or the SymbolicConstants FIRST_STEP and LAST_STEP. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • endIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the last increment of the step set in endStep or the SymbolicConstants STEP_START and STEP_END. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED. The default value is None.

  • interpolate (SymbolicConstant, default: OFF) – A SymbolicConstant specifying whether to interpolate a field read from an output database or results file. Possible values are OFF, ON or MIDSIDE_ONLY. The default value is OFF.

  • magnitudes (str, default: '') –

    A Sequence of Doubles specifying the temperature values when distributionType = UNIFORM or FIELD. The value of the magnitudes argument is a function of the crossSectionDistribution argument, as shown in the following list:

    • If crossSectionDistribution = CONSTANT_THROUGH_THICKNESS then magnitudes is a Double specifying the temperature.

    • If crossSectionDistribution = GRADIENTS_THROUGH_SHELL_CS then magnitudes is a sequence of Doubles specifying the mean value and the gradient in the thickness direction.

    • If crossSectionDistribution = GRADIENTS_THROUGH_BEAM_CS then magnitudes is a sequence of Doubles specifying the mean value, the gradient in the N1 direction, and the gradient in the N2 direction.

    • If crossSectionDistribution = POINTS_THROUGH_SECTION then magnitudes is a sequence of Doubles specifying the temperature at each point.

  • absoluteExteriorTolerance (float, default: 0) – A Float specifying the absolute value by which a driven node of the field can lie outside the region of the elements of the global model. The default value is 0.0. This argument cannot be used with midside.

  • exteriorTolerance (float, default: 0) – A Float specifying the fraction of the average element size in the global model by which a driven node of the field can lie outside the region of the elements of the global model. The default value is 0.0. This argument cannot be used with midside.

Returns:

A Temperature object.

Return type:

Temperature

Velocity(name, region, velocity1, velocity2, velocity3, omega, axisBegin, axisEnd, field='', distributionType=abaqusConstants.MAGNITUDE)[source]

This method creates a Velocity predefined field object.

Note

This function can be accessed by:

mdb.models[name].Velocity

Note

Check Velocity on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • region (Region) – A Region object specifying the region to which the predefined field is applied.

  • velocity1 (float) – A Float specifying the first component of the velocity.

  • velocity2 (float) – A Float specifying the second component of the velocity.

  • velocity3 (float) – A Float specifying the third component of the velocity.

  • omega (float) – A Float specifying the angular velocity.

  • axisBegin (tuple) – A sequence of Floats specifying the X-, Y-, and Z- coordinates of the starting point of the axis about which omega is defined.

  • axisEnd (tuple) – A sequence of Floats specifying the X-, Y-, and Z- coordinates of the end point of the axis about which omega is defined.

  • field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this predefined field. The field argument applies only when distributionType = FIELD_ANALYTICAL. The default value is an empty string.

  • distributionType (SymbolicConstant, default: MAGNITUDE) – A SymbolicConstant specifying whether the load is uniform. Possible values are MAGNITUDE and FIELD_ANALYTICAL. The default value is MAGNITUDE.

Returns:

A Velocity object.

Return type:

Velocity

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

BeamSectionProfileModel#

class BeamSectionProfileModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check BeamSectionProfileModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

beamProfilesFromOdb(fileName)

This method creates Profile objects by reading an output database.

ArbitraryProfile(name, table)

This method creates a ArbitraryProfile object.

BoxProfile(name, a, b, uniformThickness, t1)

This method creates a BoxProfile object.

CircularProfile(name, r)

This method creates a CircularProfile object.

GeneralizedProfile(name, area, i11, i12, ...)

This method creates a GeneralizedProfile object.

HexagonalProfile(name, r, t)

This method creates a HexagonalProfile object.

IProfile(name, l, h, b1, b2, t1, t2, t3)

This method creates an IProfile object.

LProfile(name, a, b, t1, t2)

This method creates a LProfile object.

PipeProfile(name, r, t)

This method creates a PipeProfile object.

RectangularProfile(name, a, b)

This method creates a RectangularProfile object.

TProfile(name, b, h, l, tf, tw)

This method creates a TProfile object.

TrapezoidalProfile(name, a, b, c, d)

This method creates a TrapezoidalProfile object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
ArbitraryProfile(name, table)[source]

This method creates a ArbitraryProfile object.

Note

This function can be accessed by:

mdb.models[name].ArbitraryProfile
session.odbs[name].ArbitraryProfile

Note

Check ArbitraryProfile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • table (tuple) – A sequence of sequences of Floats specifying the items described below.

Returns:

An ArbitraryProfile object.

Return type:

ArbitraryProfile

Raises:

RangeError –

BoxProfile(name, a, b, uniformThickness, t1, t2=0, t3=0, t4=0)[source]

This method creates a BoxProfile object.

Note

This function can be accessed by:

mdb.models[name].BoxProfile
session.odbs[name].BoxProfile

Note

Check BoxProfile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • a (float) – A Float specifying the a dimension of the box profile. For more information, see [Beam cross-section library](https://help.3ds.com/2021/English/DSSIMULIA_Established/SIMACAEELMRefMap/simaelm-c-beamcrosssectlib.htm?ContextScope=all).

  • b (float) – A Float specifying the b dimension of the box profile.

  • uniformThickness (Union[AbaqusBoolean, bool]) – A Boolean specifying whether the thickness is uniform.

  • t1 (float) – A Float specifying the uniform wall thickness if uniformThickness = ON, and the wall thickness of the first segment if uniformThickness = OFF.

  • t2 (float, default: 0) – A Float specifying the wall thickness of the second segment. t2 is required only when uniformThickness = OFF. The default value is 0.0.

  • t3 (float, default: 0) – A Float specifying the wall thickness of the third segment. t3 is required only when uniformThickness = OFF. The default value is 0.0.

  • t4 (float, default: 0) – A Float specifying the wall thickness of the fourth segment. t4 is required only when uniformThickness = OFF. The default value is 0.0.

Returns:

A BoxProfile object.

Return type:

BoxProfile

Raises:

RangeError –

CircularProfile(name, r)[source]

This method creates a CircularProfile object.

Note

This function can be accessed by:

mdb.models[name].CircularProfile
session.odbs[name].CircularProfile

Note

Check CircularProfile on help.3ds.com/2021.

Parameters:
Returns:

A CircularProfile object.

Return type:

CircularProfile

Raises:

RangeError –

GeneralizedProfile(name, area, i11, i12, i22, j, gammaO, gammaW)[source]

This method creates a GeneralizedProfile object.

Note

This function can be accessed by:

mdb.models[name].GeneralizedProfile
session.odbs[name].GeneralizedProfile

Note

Check GeneralizedProfile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • area (float) – A Float specifying the cross-sectional area for the profile.

  • i11 (float) – A Float specifying the moment of inertia for bending about the 1-axis, I11I11.

  • i12 (float) – A Float specifying the moment of inertia for cross bending, I12I12.

  • i22 (float) – A Float specifying the moment of inertia for bending about the 2-axis, I22I22.

  • j (float) – A Float specifying the torsional constant, JJ.

  • gammaO (float) – A Float specifying the sectorial moment, Γ0Γ0.

  • gammaW (float) – A Float specifying the warping constant, ΓWΓW.

Returns:

A GeneralizedProfile object.

Return type:

GeneralizedProfile

Raises:

RangeError –

HexagonalProfile(name, r, t)[source]

This method creates a HexagonalProfile object.

Note

This function can be accessed by:

mdb.models[name].HexagonalProfile
session.odbs[name].HexagonalProfile

Note

Check HexagonalProfile on help.3ds.com/2021.

Parameters:
Returns:

A HexagonalProfile object.

Return type:

HexagonalProfile

Raises:

RangeError –

IProfile(name, l, h, b1, b2, t1, t2, t3)[source]

This method creates an IProfile object.

Note

This function can be accessed by:

mdb.models[name].IProfile
session.odbs[name].IProfile

Note

Check IProfile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • l (float) – A Float specifying the l dimension (offset of 1-axis from the bottom flange surface) of the I profile. For more information, see [Beam cross-section library](https://help.3ds.com/2021/English/DSSIMULIA_Established/SIMACAEELMRefMap/simaelm-c-beamcrosssectlib.htm?ContextScope=all).

  • h (float) – A Float specifying the h dimension (height) of the I profile.

  • b1 (float) – A Float specifying the b1 dimension (bottom flange width) of the I profile.

  • b2 (float) – A Float specifying the b2 dimension (top flange width) of the I profile.

  • t1 (float) – A Float specifying the t1 dimension (bottom flange thickness) of the I profile.

  • t2 (float) – A Float specifying the t2 dimension (top flange thickness) of the I profile.

  • t3 (float) – A Float specifying the t3 dimension (web thickness) of the I profile.

Returns:

An IProfile object.

Return type:

IProfile

Raises:

RangeError –

LProfile(name, a, b, t1, t2)[source]

This method creates a LProfile object.

Note

This function can be accessed by:

mdb.models[name].LProfile
session.odbs[name].LProfile

Note

Check LProfile on help.3ds.com/2021.

Parameters:
Returns:

A LProfile object.

Return type:

LProfile

Raises:

RangeError –

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

PipeProfile(name, r, t)[source]

This method creates a PipeProfile object.

Note

This function can be accessed by:

mdb.models[name].PipeProfile
session.odbs[name].PipeProfile

Note

Check PipeProfile on help.3ds.com/2021.

Parameters:
Returns:

A PipeProfile object.

Return type:

PipeProfile

Raises:

RangeError –

RectangularProfile(name, a, b)[source]

This method creates a RectangularProfile object.

Note

This function can be accessed by:

mdb.models[name].RectangularProfile
session.odbs[name].RectangularProfile

Note

Check RectangularProfile on help.3ds.com/2021.

Parameters:
Returns:

A RectangularProfile object.

Return type:

RectangularProfile

Raises:

RangeError –

TProfile(name, b, h, l, tf, tw)[source]

This method creates a TProfile object.

Note

This function can be accessed by:

mdb.models[name].TProfile
session.odbs[name].TProfile

Note

Check TProfile on help.3ds.com/2021.

Parameters:
Returns:

A TProfile object.

Return type:

TProfile

Raises:

RangeError –

TrapezoidalProfile(name, a, b, c, d)[source]

This method creates a TrapezoidalProfile object.

Note

This function can be accessed by:

mdb.models[name].TrapezoidalProfile
session.odbs[name].TrapezoidalProfile

Note

Check TrapezoidalProfile on help.3ds.com/2021.

Parameters:
Returns:

A TrapezoidalProfile object.

Return type:

TrapezoidalProfile

Raises:

RangeError –

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

beamProfilesFromOdb(fileName)[source]

This method creates Profile objects by reading an output database. The new profiles are placed in the profiles repository.

Note

This function can be accessed by:

mdb.models[name].beamProfilesFromOdb

Note

Check Model.beamProfilesFromOdb on help.3ds.com/2021.

Parameters:

fileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read. The String can also be the full path to the output database file if it is located in another directory.

Returns:

A list of Profile objects.

Return type:

List[Profile]

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

OutputModel#

class OutputModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check OutputModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

FieldOutputRequest(name, createStepName[, ...])

This method creates a FieldOutputRequest object.

HistoryOutputRequest(name, createStepName[, ...])

This method creates a HistoryOutputRequest object.

IntegratedOutputSection(name, surface[, ...])

This method creates an IntegratedOutputSection object.

TimePoint(name, points)

This method creates a TimePoint object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
FieldOutputRequest(name, createStepName, region=abaqusConstants.MODEL, variables=abaqusConstants.PRESELECT, frequency=1, modes=abaqusConstants.ALL, timeInterval=abaqusConstants.EVERY_TIME_INCREMENT, numIntervals=20, timeMarks=OFF, boltLoad='', sectionPoints=abaqusConstants.DEFAULT, interactions=None, rebar=abaqusConstants.EXCLUDE, filter=None, directions=ON, fasteners='', assembledFastener='', assembledFastenerSet='', exteriorOnly=OFF, layupNames='', layupLocationMethod=abaqusConstants.SPECIFIED, outputAtPlyTop=False, outputAtPlyMid=True, outputAtPlyBottom=False, position=abaqusConstants.INTEGRATION_POINTS)[source]

This method creates a FieldOutputRequest object.

Note

This function can be accessed by:

mdb.models[name].FieldOutputRequest

Note

Check FieldOutputRequest on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the object is created.

  • region (Union[Literal[MODEL], Region], default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region from which output is requested. The SymbolicConstant MODEL represents the whole model. The default value is MODEL.

  • variables (Union[Tuple[str, ...], Literal[PRESELECT, ALL]], default: PRESELECT) – A sequence of Strings specifying output request variable or component names, or the SymbolicConstant PRESELECT or ALL. PRESELECT represents all default output variables for the given step. ALL represents all valid output variables. The default value is PRESELECT.

  • frequency (Union[int, Literal[LAST_INCREMENT]], default: 1) – The SymbolicConstant LAST_INCREMENT or an Int specifying the output frequency in increments. The default value is 1.

  • modes (Union[Literal[ALL], Tuple[int, ...]], default: ALL) – The SymbolicConstant ALL or a sequence of Ints specifying a list of eigenmodes for which output is desired. The default value is ALL.

  • timeInterval (Union[Literal[EVERY_TIME_INCREMENT], float], default: EVERY_TIME_INCREMENT) – The SymbolicConstant EVERY_TIME_INCREMENT or a Float specifying the time interval at which the output states are to be written. The default value is EVERY_TIME_INCREMENT.

  • numIntervals (int, default: 20) – An Int specifying the number of intervals during the step at which output database states are to be written. The default value is 20.

  • timeMarks (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying when to write results to the output database. OFF indicates that output is written immediately after the time dictated by the specified number of intervals. ON indicates that output is written at the exact times dictated by the specified number of intervals. The default value is OFF.

  • boltLoad (str, default: '') – A String specifying a bolt load from which output is requested.

  • sectionPoints (Union[Literal[DEFAULT], Tuple[int, ...]], default: DEFAULT) – The SymbolicConstant DEFAULT or a sequence of Ints specifying the section points for which output requested. The default is DEFAULT.

  • interactions (Optional[str], default: None) – None or a sequence of Strings specifying the interaction names. The default value is None.The sequence can contain only one String.

  • rebar (Literal[EXCLUDE, INCLUDE, ONLY], default: EXCLUDE) – A SymbolicConstant specifying whether output is requested for rebar. Possible values are EXCLUDE, INCLUDE, and ONLY. The default value is EXCLUDE.

  • filter (Optional[SymbolicConstant], default: None) – The SymbolicConstant ANTIALIASING or a String specifying the name of an output filter object. The default value is None.

  • directions (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to output directions of the local material coordinate system. The default value is ON.

  • fasteners (str, default: '') – A String specifying the fastener name. The default value is an empty string.

  • assembledFastener (str, default: '') – A String specifying the assembled fastener name. The default value is an empty string.

  • assembledFastenerSet (str, default: '') – A String specifying the set name from the model referenced by the assembled fastener, assembledFastener. The default value is an empty string.

  • exteriorOnly (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the output domain is restricted to the exterior of the model. This argument is only valid if region = MODEL. The default value is OFF.

  • layupNames (str, default: '') – A List of Composite Layer Names.

  • layupLocationMethod (str, default: SPECIFIED) – A Symbolic constant specifying the method used to indicate the output locations for composite layups. Possible values are ALL_LOCATIONS, SPECIFIED and TYPED_IN. The default value is SPECIFIED.

  • outputAtPlyTop (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to output at the ply top section point. The default value is False.

  • outputAtPlyMid (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to output at the ply mid section point. The default value is True.

  • outputAtPlyBottom (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to output at the ply bottom section point. The default value is False.

  • position (Literal[INTEGRATION_POINTS, AVERAGED_AT_NODES, CENTROIDAL, NODES], default: INTEGRATION_POINTS) – A SymbolicConstant specifying the position on an element where output needs to be written. Possible values are INTEGRATION_POINTS, AVERAGED_AT_NODES, CENTROIDAL, and NODES. The default value is INTEGRATION_POINTS.

Returns:

A FieldOutputRequest object.

Return type:

FieldOutputRequest

HistoryOutputRequest(name, createStepName, region=abaqusConstants.MODEL, variables=abaqusConstants.PRESELECT, frequency=1, modes=abaqusConstants.ALL, timeInterval=abaqusConstants.EVERY_TIME_INCREMENT, numIntervals=20, boltLoad='', sectionPoints=abaqusConstants.DEFAULT, stepName='', interactions=None, contourIntegral=None, numberOfContours=0, stressInitializationStep=None, contourType=abaqusConstants.J_INTEGRAL, kFactorDirection=abaqusConstants.MTS, rebar=abaqusConstants.EXCLUDE, integratedOutputSection='', springs=None, filter=None, fasteners='', assembledFastener='', assembledFastenerSet='', sensor=OFF, useGlobal=True)[source]

This method creates a HistoryOutputRequest object.

Note

This function can be accessed by:

mdb.models[name].HistoryOutputRequest

Note

Check HistoryOutputRequest on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • createStepName (str) – A String specifying the name of the step in which the object is created.

  • region (Union[Literal[MODEL], Region], default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region from which output is requested. The SymbolicConstant MODEL represents the whole model. The default value is MODEL. If the region is a surface region, the surface must lie within the general contact surface domain.

  • variables (Union[Tuple[str, ...], Literal[PRESELECT, ALL]], default: PRESELECT) – A sequence of Strings specifying output request variable or component names, or the SymbolicConstant PRESELECT or ALL. PRESELECT represents all default output variables for the given step. ALL represents all valid output variables. The default value is PRESELECT.

  • frequency (Union[int, Literal[LAST_INCREMENT]], default: 1) – The SymbolicConstant LAST_INCREMENT or an Int specifying the output frequency in increments. The default value is 1.

  • modes (Union[Literal[ALL], Tuple[int, ...]], default: ALL) – The SymbolicConstant ALL or a sequence of Ints specifying a list of eigenmodes for which output is desired. The default value is ALL.

  • timeInterval (Union[Literal[EVERY_TIME_INCREMENT], float], default: EVERY_TIME_INCREMENT) – The SymbolicConstant EVERY_TIME_INCREMENT or a Float specifying the time interval at which the output states are to be written. The default value is EVERY_TIME_INCREMENT.

  • numIntervals (int, default: 20) – An Int specifying the number of intervals during the step at which output database states are to be written. The default value is 20.

  • boltLoad (str, default: '') – A String specifying a bolt load from which output is requested. The default value is an empty string.

  • sectionPoints (Union[Literal[DEFAULT], Tuple[int, ...]], default: DEFAULT) – The SymbolicConstant DEFAULT or a sequence of Ints specifying the section points for which output is requested. The default value is DEFAULT.

  • stepName (str, default: '') – A String specifying the name of the step. The default value is an empty string.

  • interactions (Optional[str], default: None) – None or a sequence of Strings specifying the interaction names. The default value is None.The sequence can contain only one String.

  • contourIntegral (Optional[str], default: None) – A String specifying the contour integral name. The default value is None.

  • numberOfContours (int, default: 0) – An Int specifying the number of contour integrals to output for the contour integral object. The default value is 0.

  • stressInitializationStep (Optional[str], default: None) – A String specifying the name of the stress initialization step. The default value is None.

  • contourType (Literal[J_INTEGRAL, C_INTEGRAL, T_STRESS, K_FACTORS], default: J_INTEGRAL) – A SymbolicConstant specifying the type of contour integral. Possible values are J_INTEGRAL, C_INTEGRAL, T_STRESS, and K_FACTORS. The default value is J_INTEGRAL.

  • kFactorDirection (Literal[MTS, MERR, K110], default: MTS) – A SymbolicConstant specifying the stress intensity factor direction. Possible values are MTS, MERR, and K110. The kFactorDirection argument is valid only if contourType = K_FACTORS. The default value is MTS.

  • rebar (Literal[EXCLUDE, INCLUDE, ONLY], default: EXCLUDE) – A SymbolicConstant specifying whether output is requested for rebar. Possible values are EXCLUDE, INCLUDE, and ONLY. The default value is EXCLUDE.

  • integratedOutputSection (str, default: '') – A String specifying the integrated output section. The default value is an empty string.

  • springs (Optional[tuple], default: None) – A sequence of Strings specifying the springs/dashpots names. The default value is None. The sequence can contain only one String.

  • filter (Optional[SymbolicConstant], default: None) – The SymbolicConstant ANTIALIASING or a String specifying the name of an output filter object. The default value is None.

  • fasteners (str, default: '') – A String specifying the fastener name. The default value is an empty string.

  • assembledFastener (str, default: '') – A String specifying the assembled fastener name. The default value is an empty string.

  • assembledFastenerSet (str, default: '') – A String specifying the set name from the model referenced by the assembled fastener, assembledFastener. The default value is an empty string.

  • sensor (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to associate the output request with a sensor definition. The default value is OFF.

  • useGlobal (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to output vector-valued nodal variables in the global directions. The default value is True.

Returns:

A HistoryOutputRequest object.

Return type:

HistoryOutputRequest

IntegratedOutputSection(name, surface, refPoint=None, refPointAtCenter=OFF, refPointMotion=abaqusConstants.INDEPENDENT, localCsys=None, projectOrientation=OFF)[source]

This method creates an IntegratedOutputSection object.

Note

This function can be accessed by:

mdb.models[name].IntegratedOutputSection

Note

Check IntegratedOutputSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • surface (Region) – A Region object specifying the surface over which the output is based.

  • refPoint (Optional[SymbolicConstant], default: None) – None or a Region object specifying the anchor point about which the integrated moment over the output region is computed or the SymbolicConstant None representing the global origin. The default value is None.

  • refPointAtCenter (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the refPoint be adjusted so that it coincides with the center of the output region in the initial configuration. This argument is valid only when you include the refPoint argument. The default value is OFF.

  • refPointMotion (Literal[AVERAGE_TRANSLATION, AVERAGE, INDEPENDENT], default: INDEPENDENT) – A SymbolicConstant specifying how to relate the motion of refPoint to the average motion of the output region. A value of INDEPENDENT will allow the refPoint to move independent of the output region. A value of AVERAGE_TRANSLATION will set the displacement of the refPoint equal to the average translation of the output region. A value of AVERAGE will set the displacement and rotation of the refPoint equal to the average translation of the output region. The default value is INDEPENDENT.This argument is valid only when you include the refPoint argument.

  • localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system used to express vector output. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

  • projectOrientation (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the coordinate system be projected onto the surface such that the 1-axis is normal to the surface. Projection onto a planar surface is such that the 1-axis is normal to the surface, and a projection onto a nonplanar surface is such that a least-squares fit surface will be used. The default value is OFF.

Returns:

An IntegratedOutputSection object.

Return type:

IntegratedOutputSection

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

TimePoint(name, points)[source]

This method creates a TimePoint object.

Note

This function can be accessed by:

mdb.models[name].TimePoint

Note

Check TimePoint on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • points (tuple) – A sequence of sequences of Floats specifying time points at which data are written to the output database or restart files.

Returns:

A TimePoint object.

Return type:

TimePoint

Raises:

  • InvalidNameError –

  • RangeError –

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

SectionModel#

class SectionModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check SectionModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

AcousticInfiniteSection(name, material[, ...])

This method creates an AcousticInfiniteSection object.

AcousticInterfaceSection(name[, thickness])

This method creates an AcousticInterfaceSection object.

BeamSection(name, integration, profile[, ...])

This method creates a BeamSection object.

CohesiveSection(name, response, material[, ...])

This method creates a CohesiveSection object.

CompositeShellSection(name, layup[, ...])

This method creates a CompositeShellSection object.

CompositeSolidSection(name, layup[, ...])

This method creates a CompositeSolidSection object.

ConnectorSection(name[, assembledType, ...])

This method creates a ConnectorSection object.

EulerianSection(name, data)

This method creates a EulerianSection object.

GasketSection(name, material[, ...])

This method creates a GasketSection object.

GeneralStiffnessSection(name, stiffnessMatrix)

This method creates a GeneralStiffnessSection object.

HomogeneousShellSection(name, material[, ...])

This method creates a HomogeneousShellSection object.

HomogeneousSolidSection(name, material[, ...])

This method creates a HomogeneousSolidSection object.

MembraneSection(name, material[, thickness, ...])

This method creates a MembraneSection object.

MPCSection(name, mpcType[, userMode, userType])

This method creates a MPCSection object.

PEGSection(name, material[, thickness, ...])

This method creates a PEGSection object.

SurfaceSection(name[, useDensity, density])

This method creates a SurfaceSection object.

TrussSection(name, material[, area])

This method creates a TrussSection object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
AcousticInfiniteSection(name, material, thickness=1, order=10)[source]

This method creates an AcousticInfiniteSection object.

Note

This function can be accessed by:

mdb.models[name].AcousticInfiniteSection
session.odbs[name].AcousticInfiniteSection

Note

Check AcousticInfiniteSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • material (str) – A String specifying the name of the material.

  • thickness (float, default: 1) – A Float specifying the thickness of the section. Possible values are thickness >> 0.0. The default value is 1.0.

  • order (int, default: 10) – An Int specifying the number of ninth-order polynomials that will be used to resolve the variation of the acoustic field in the infinite direction. Possible values are 0 << order ≤ 10. The default value is 10.

Returns:

An AcousticInfiniteSection object.

Return type:

AcousticInfiniteSection

Raises:

  • InvalidNameError –

  • RangeError –

AcousticInterfaceSection(name, thickness=1)[source]

This method creates an AcousticInterfaceSection object.

Note

This function can be accessed by:

mdb.models[name].AcousticInterfaceSection
session.odbs[name].AcousticInterfaceSection

Note

Check AcousticInterfaceSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • thickness (float, default: 1) – A Float specifying the thickness of the section. Possible values are thickness >> 0.0. The default value is 1.0.

Returns:

An AcousticInterfaceSection object.

Return type:

AcousticInterfaceSection

Raises:

  • InvalidNameError –

  • RangeError –

BeamSection(name, integration, profile, poissonRatio=0, thermalExpansion=OFF, temperatureDependency=OFF, dependencies=0, density=None, referenceTemperature=None, temperatureVar=abaqusConstants.LINEAR, alphaDamping=0, betaDamping=0, compositeDamping=0, useFluidInertia=OFF, submerged=abaqusConstants.FULLY, fluidMassDensity=None, crossSectionRadius=None, lateralMassCoef=1, axialMassCoef=0, massOffsetX=0, massOffsetY=0, beamShape=abaqusConstants.CONSTANT, material='', table=(), outputPts=(), centroid=(0.0, 0.0), shearCenter=(0.0, 0.0), profileEnd='')[source]

This method creates a BeamSection object.

Note

This function can be accessed by:

mdb.models[name].BeamSection
session.odbs[name].BeamSection

Note

Check BeamSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • integration (Literal[BEFORE_ANALYSIS, DURING_ANALYSIS]) – A SymbolicConstant specifying the integration method for the section. Possible values are BEFORE_ANALYSIS and DURING_ANALYSIS.

  • profile (str) – A String specifying the name of the profile. This argument represents the start profile in case of beamShape = TAPERED.

  • poissonRatio (float, default: 0) – A Float specifying the Poisson’s ratio of the section. The default value is 0.0.

  • thermalExpansion (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to use thermal expansion data. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • density (Optional[float], default: None) – None or a Float specifying the density of the section. The default value is None.

  • referenceTemperature (Optional[float], default: None) – None or a Float specifying the reference temperature of the section. The default value is None.

  • temperatureVar (Literal[LINEAR, INTERPOLATED], default: LINEAR) – A SymbolicConstant specifying the temperature variation for the section. Possible values are LINEAR and INTERPOLATED. The default value is LINEAR.

  • alphaDamping (float, default: 0) – A Float specifying the αRαR factor to create mass proportional damping in direct-integration dynamics. The default value is 0.0.

  • betaDamping (float, default: 0) – A Float specifying the βRβR factor to create stiffness proportional damping in direct-integration dynamics. The default value is 0.0.

  • compositeDamping (float, default: 0) – A Float specifying the fraction of critical damping to be used in calculating composite damping factors for the modes (for use in modal dynamics). The default value is 0.0.

  • useFluidInertia (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether added mass effects will be simulated. The default value is OFF.

  • submerged (Literal[FULLY, HALF], default: FULLY) – A SymbolicConstant specifying whether the section is either full submerged or half submerged. This argument applies only when useFluidInertia = True. Possible values are FULLY and HALF. The default value is FULLY.

  • fluidMassDensity (Optional[float], default: None) – None or a Float specifying the mass density of the fluid. This argument applies only when useFluidInertia = True and must be specified in that case. The default value is None.

  • crossSectionRadius (Optional[float], default: None) – None or a Float specifying the radius of the cylindrical cross-section. This argument applies only when useFluidInertia = True and must be specified in that case. The default value is None.

  • lateralMassCoef (float, default: 1) – A Float specifying the added mass coefficient, CACA, for lateral motions of the beam. This argument applies only when*useFluidInertia* = True. The default value is 1.0.

  • axialMassCoef (float, default: 0) – A Float specifying the added mass coefficient, C(A−E)C(A-E), for motions along the axis of the beam. This argument affects only the term added to the free end(s) of the beam, and applies only when useFluidInertia = True. The default value is 0.0.

  • massOffsetX (float, default: 0) – A Float specifying the local 1-coordinate of the center of the cylindrical cross-section with respect to the beam cross-section. This argument applies only when useFluidInertia = True. The default value is 0.0.

  • massOffsetY (float, default: 0) – A Float specifying the local 2-coordinate of the center of the cylindrical cross-section with respect to the beam cross-section. This argument applies only when useFluidInertia = True. The default value is 0.0.

  • beamShape (Literal[CONSTANT, TAPERED], default: CONSTANT) – A SymbolicConstant specifying the change in cross-section of the beam along length. Possible values are CONSTANT and TAPERED. The default value is CONSTANT. This parameter is available for manipulating the model database but not for the ODB API.

  • material (str, default: '') – A String specifying the name of the material. The default value is an empty string. The material is required when integration is “DURING_ANALYSIS”.

  • table (tuple, default: ()) – A sequence of sequences of Floats specifying the items described below. The default value is an empty sequence.

  • outputPts (tuple, default: ()) – A sequence of pairs of Floats specifying the positions at which output is requested. The default value is an empty sequence.

  • centroid (Tuple[float, float], default: (0.0, 0.0)) – A pair of Floats specifying the X - Y coordinates of the centroid. The default value is (0.0, 0.0).

  • shearCenter (Tuple[float, float], default: (0.0, 0.0)) – A pair of Floats specifying the X - Y coordinates of the shear center. The default value is (0.0, 0.0).

  • profileEnd (str, default: '') – A String specifying the name of the end profile. The type of the end profile must be same as that of the start profile. This argument is valid only when beamShape = TAPERED. The default value is an empty string. This parameter is available for manipulating the model database but not for the ODB API.

Returns:

A BeamSection object.

Return type:

BeamSection

CohesiveSection(name, response, material, initialThicknessType=abaqusConstants.SOLVER_DEFAULT, initialThickness=1, outOfPlaneThickness=None)[source]

This method creates a CohesiveSection object.

Note

This function can be accessed by:

mdb.models[name].CohesiveSection
session.odbs[name].CohesiveSection

Note

Check CohesiveSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • response (Literal[TRACTION_SEPARATION, CONTINUUM, GASKET]) – A SymbolicConstant specifying the geometric assumption that defines the constitutive behavior of the cohesive elements. Possible values are TRACTION_SEPARATION, CONTINUUM, and GASKET.

  • material (str) – A String specifying the name of the material.

  • initialThicknessType (Literal[SOLVER_DEFAULT, SPECIFY], default: SOLVER_DEFAULT) – A SymbolicConstant specifying the method used to compute the initial thickness. Possible values are:SOLVER_DEFAULT, specifying that Abaqus will use the analysis product defaultGEOMETRY, specifying that Abaqus will compute the thickness from the nodal coordinates of the elements.SPECIFY, specifying that Abaqus will use the value given for initialThickness The default value is SOLVER_DEFAULT.

  • initialThickness (float, default: 1) – A Float specifying the initial thickness for the section. The initialThickness argument applies only when initialThicknessType = SPECIFY. The default value is 1.0.

  • outOfPlaneThickness (Optional[float], default: None) – None or a Float specifying the out-of-plane thickness for the section. The default value is None.

Returns:

A CohesiveSection object.

Return type:

CohesiveSection

Raises:

RangeError –

CompositeShellSection(name, layup, symmetric=OFF, thicknessType=abaqusConstants.UNIFORM, preIntegrate=OFF, poissonDefinition=abaqusConstants.DEFAULT, poisson=0, integrationRule=abaqusConstants.SIMPSON, temperature=abaqusConstants.GRADIENT, idealization=abaqusConstants.NO_IDEALIZATION, nTemp=None, thicknessModulus=None, useDensity=OFF, density=0, layupName='', thicknessField='', nodalThicknessField='')[source]

This method creates a CompositeShellSection object.

Note

This function can be accessed by:

mdb.models[name].parts[name].compositeLayups[i].CompositeShellSection
mdb.models[name].CompositeShellSection
session.odbs[name].CompositeShellSection

Note

Check CompositeShellSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • layup (List[SectionLayer]) – A SectionLayerArray object specifying the shell cross-section.

  • symmetric (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not the layup should be made symmetric by the analysis. The default value is OFF.

  • thicknessType (Literal[UNIFORM, ANALYTICAL_FIELD, DISCRETE_FIELD, NODAL_ANALYTICAL_FIELD, NODAL_DISCRETE_FIELD], default: UNIFORM) – A SymbolicConstant specifying the distribution used for defining the thickness of the elements. Possible values are UNIFORM, ANALYTICAL_FIELD, DISCRETE_FIELD, NODAL_ANALYTICAL_FIELD, and NODAL_DISCRETE_FIELD. The default value is UNIFORM.

  • preIntegrate (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the shell section properties are specified by the user prior to the analysis (ON) or integrated during the analysis (OFF). The default value is OFF.

  • poissonDefinition (Literal[DEFAULT, VALUE], default: DEFAULT) – A SymbolicConstant specifying whether to use the default value for the Poisson’s ratio. Possible values are:DEFAULT, specifying that the default value for the Poisson’s ratio is 0.5 in an Abaqus/Standard analysis and is obtained from the material definition in an Abaqus/Explicit analysis.VALUE, specifying that the Poisson’s ratio used in the analysis is the value provided in poisson.The default value is DEFAULT.

  • poisson (float, default: 0) – A Float specifying the Poisson’s ratio. Possible values are −1.0 ≤ poisson ≤ 0.5. This argument is valid only when poissonDefinition = VALUE. The default value is 0.5.

  • integrationRule (Literal[SIMPSON, GAUSS], default: SIMPSON) – A SymbolicConstant specifying the shell section integration rule. Possible values are SIMPSON and GAUSS. The default value is SIMPSON.

  • temperature (Literal[GRADIENT, POINTWISE], default: GRADIENT) – A SymbolicConstant specifying the mode used for temperature and field variable input across the section thickness. Possible values are GRADIENT and POINTWISE. The default value is GRADIENT.

  • idealization (Literal[NO_IDEALIZATION, SMEAR_ALL_LAYERS, MEMBRANE, BENDING], default: NO_IDEALIZATION) – A SymbolicConstant specifying the mechanical idealization used for the section calculations. This member is only applicable when preIntegrate is set to ON. Possible values are NO_IDEALIZATION, SMEAR_ALL_LAYERS, MEMBRANE, and BENDING. The default value is NO_IDEALIZATION.

  • nTemp (Optional[int], default: None) – None or an Int specifying the number of temperature points to be input. This argument is valid only when temperature = POINTWISE. The default value is None.

  • thicknessModulus (Optional[float], default: None) – None or a Float specifying the effective thickness modulus. This argument is relevant only for continuum shells and must be used in conjunction with the argument poisson. The default value is None.

  • useDensity (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not to use the value of density. The default value is OFF.

  • density (float, default: 0) – A Float specifying the value of density to apply to this section. The default value is 0.0.

  • layupName (str, default: '') – A String specifying the layup name for this section. The default value is an empty string.

  • thicknessField (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object used to define the thickness of the shell elements. The thicknessField argument applies only when thicknessType = ANALYTICAL_FIELD or thicknessType = DISCRETE_FIELD. The default value is an empty string.

  • nodalThicknessField (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object used to define the thickness of the shell elements at each node. The nodalThicknessField argument applies only when thicknessType = NODAL_ANALYTICAL_FIELD or thicknessType = NODAL_DISCRETE_FIELD. The default value is an empty string.

Returns:

A CompositeShellSection object.

Return type:

CompositeShellSection

CompositeSolidSection(name, layup, symmetric=OFF, layupName='')[source]

This method creates a CompositeSolidSection object.

Note

This function can be accessed by:

mdb.models[name].CompositeSolidSection
session.odbs[name].CompositeSolidSection

Note

Check CompositeSolidSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • layup (List[SectionLayer]) – A SectionLayerArray object specifying the solid cross-section.

  • symmetric (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not the layup should be made symmetric by the analysis. The default value is OFF.

  • layupName (str, default: '') – A String specifying the layup name for this section. The default value is an empty string.

Returns:

A CompositeSolidSection object.

Return type:

CompositeSolidSection

ConnectorSection(name, assembledType=abaqusConstants.NONE, rotationalType=abaqusConstants.NONE, translationalType=abaqusConstants.NONE, integration=abaqusConstants.UNSPECIFIED, u1ReferenceLength=None, u2ReferenceLength=None, u3ReferenceLength=None, ur1ReferenceAngle=None, ur2ReferenceAngle=None, ur3ReferenceAngle=None, massPerLength=None, contactAngle=None, materialFlowFactor=1.0, regularize=ON, defaultTolerance=ON, regularization=0.03, extrapolation=abaqusConstants.CONSTANT, behaviorOptions=Ellipsis)[source]

This method creates a ConnectorSection object.

Note

This function can be accessed by:

mdb.models[name].ConnectorSection
session.odbs[name].ConnectorSection

Note

Check ConnectorSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • assembledType (Literal[NONE, BEAM, BUSHING, CVJOINT, CYLINDRICAL, HINGE, PLANAR, RETRACTOR, SLIPRING, TRANSLATOR, UJOINT, WELD], default: NONE) – A SymbolicConstant specifying the assembled connection type. Possible values are:NONEBEAMBUSHINGCVJOINTCYLINDRICALHINGEPLANARRETRACTORSLIPRINGTRANSLATORUJOINTWELDThe default value is NONE.You cannot include the assembledType argument if translationalType or rotationalType are given a value other than NONE. At least one of the arguments assembledType, translationalType, or rotationalType must be given a value other than NONE.

  • rotationalType (Literal[NONE, ALIGN, CARDAN, CONSTANT_VELOCITY, EULER, FLEXION_TORSION, FLOW_CONVERTER, PROJECTION_FLEXION_TORSION, REVOLUTE, ROTATION, ROTATION_ACCELEROMETER, UNIVERSAL], default: NONE) – A SymbolicConstant specifying the basic rotational connection type. Possible values are:NONEALIGNCARDANCONSTANT_VELOCITYEULERFLEXION_TORSIONFLOW_CONVERTERPROJECTION_FLEXION_TORSIONREVOLUTEROTATIONROTATION_ACCELEROMETERUNIVERSALThe default value is NONE.You cannot include the rotationalType argument if assembledType is given a value other than NONE. At least one of the arguments assembledType, translationalType, or rotationalType must be given an value other than NONE.

  • translationalType (Literal[NONE, ACCELEROMETER, AXIAL, CARTESIAN, JOIN, LINK, PROJECTION_CARTESIAN, RADIAL_THRUST, SLIDE_PLANE, SLOT], default: NONE) – A SymbolicConstant specifying the basic translational connection type. Possible values are:NONEACCELEROMETERAXIALCARTESIANJOINLINKPROJECTION_CARTESIANRADIAL_THRUSTSLIDE_PLANESLOTThe default value is NONE.You cannot include the translationalType argument if assembledType is given a value other than NONE. At least one of the arguments assembledType, translationalType, or rotationalType must be given an value other than NONE.

  • integration (Literal[UNSPECIFIED, IMPLICIT, EXPLICIT], default: UNSPECIFIED) – A SymbolicConstant specifying the time integration scheme to use for analysis. This argument is applicable only to an Abaqus/Explicit analysis. Possible values are UNSPECIFIED, IMPLICIT, and EXPLICIT. The default value is UNSPECIFIED.

  • u1ReferenceLength (Optional[float], default: None) – None or a Float specifying the reference length associated with constitutive response for the first component of relative motion. The default value is None.

  • u2ReferenceLength (Optional[float], default: None) – None or a Float specifying the reference length associated with constitutive response for the second component of relative motion. The default value is None.

  • u3ReferenceLength (Optional[float], default: None) – None or a Float specifying the reference length associated with constitutive response for the third component of relative motion. The default value is None.

  • ur1ReferenceAngle (Optional[float], default: None) – None or a Float specifying the reference angle in degrees associated with constitutive response for the fourth component of relative motion. The default value is None.

  • ur2ReferenceAngle (Optional[float], default: None) – None or a Float specifying the reference angle in degrees associated with constitutive response for the fifth component of relative motion. The default value is None.

  • ur3ReferenceAngle (Optional[float], default: None) – None or a Float specifying the reference angle in degrees associated with constitutive response for the sixth component of relative motion. The default value is None.

  • massPerLength (Optional[float], default: None) – None or a Float specifying the mass per unit reference length of belt material. This argument is applicable only when assembledType = SLIPRING, and must be specified in that case. The default value is None.

  • contactAngle (Optional[float], default: None) – None or a Float specifying the contact angle made by the belt wrapping around node b. This argument is applicable only to an Abaqus/Explicit analysis, and only when assembledType = SLIPRING. The default value is None.

  • materialFlowFactor (float, default: 1.0) – A Float specifying the scaling factor for material flow at node b. This argument is applicable only when assembledType = RETRACTOR or rotationalType = FLOW_CONVERTER. The default value is 1.0.

  • regularize (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether or not all tabular data associated with the behaviorOptions will be regularized. This argument is applicable only for an Abaqus/Explicit analysis. The default value is ON.

  • defaultTolerance (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether or not the default regularization tolerance will be used for all tabular data associated with the behaviorOptions. This argument is applicable only for an Abaqus/Explicit analysis and only if regularize = ON. The default value is ON.

  • regularization (float, default: 0.03) – A Float specifying the regularization increment to be used for all tabular data associated with the behaviorOptions. This argument is applicable only for an Abaqus/Explicit analysis and only if regularize = ON and defaultTolerance = OFF. The default value is 0.03.

  • extrapolation (Literal[CONSTANT, LINEAR], default: CONSTANT) – A SymbolicConstant specifying the extrapolation technique to be used for all tabular data associated with the behaviorOptions. Possible values are CONSTANT and LINEAR. The default value is CONSTANT.

  • behaviorOptions (List[ConnectorBehaviorOption], default: Ellipsis) – A ConnectorBehaviorOptionArray object.

Returns:

A ConnectorSection object.

Return type:

ConnectorSection

Raises:

  • InvalidNameError –

  • RangeError –

EulerianSection(name, data)[source]

This method creates a EulerianSection object.

Note

This function can be accessed by:

mdb.models[name].EulerianSection
session.odbs[name].EulerianSection

Note

Check EulerianSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • data (str) – A String-to-String Dictionary specifying a dictionary mapping Material instance names to Material names. Internally the specified mapping gets sorted on Material instance name.

Returns:

An EulerianSection object.

Return type:

EulerianSection

GasketSection(name, material, crossSection=1, initialGap=0, initialThickness=abaqusConstants.DEFAULT, initialVoid=0, stabilizationStiffness=abaqusConstants.DEFAULT)[source]

This method creates a GasketSection object.

Note

This function can be accessed by:

mdb.models[name].GasketSection
session.odbs[name].GasketSection

Note

Check GasketSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • material (str) – A String specifying the name of the material of which the gasket is made or material that defines gasket behavior.

  • crossSection (float, default: 1) – A Float specifying the cross-sectional area, width, or out-of-plane thickness, if applicable, depending on the gasket element type. The default value is 1.0.

  • initialGap (float, default: 0) – A Float specifying the initial gap. The default value is 0.0.

  • initialThickness (Union[Literal[DEFAULT], float], default: DEFAULT) – The SymbolicConstant DEFAULT or a Float specifying the initial gasket thickness. If DEFAULT is specified, the initial thickness is determined using nodal coordinates. The default value is DEFAULT.

  • initialVoid (float, default: 0) – A Float specifying the initial void. The default value is 0.0.

  • stabilizationStiffness (Union[Literal[DEFAULT], float], default: DEFAULT) – The SymbolicConstant DEFAULT or a Float specifying the default stabilization stiffness used in all but link elements to stabilize gasket elements that are not supported at all nodes, such as those that extend outside neighboring components. If DEFAULT is specified, a value is used equal to 10-9 times the initial compressive stiffness in the thickness direction. The default value is DEFAULT.

Returns:

A GasketSection object. and ValueError.

Return type:

GasketSection

GeneralStiffnessSection(name, stiffnessMatrix, referenceTemperature=None, applyThermalStress=OFF, temperatureDependency=OFF, dependencies=0, poissonDefinition=abaqusConstants.DEFAULT, poisson=0, useDensity=OFF, density=0, thermalStresses=(), scalingData=())[source]

This method creates a GeneralStiffnessSection object.

Note

This function can be accessed by:

mdb.models[name].GeneralStiffnessSection
session.odbs[name].GeneralStiffnessSection

Note

Check GeneralStiffnessSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • stiffnessMatrix (tuple) – A sequence of Floats specifying the stiffness matrix for the section in the order D11, D12, D22, D13, D23, D33, …., D66. Twenty-one entries must be given.

  • referenceTemperature (Optional[float], default: None) – None or a Float specifying the reference temperature for thermal expansion. The default value is None.

  • applyThermalStress (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not the section stiffness varies with thermal stresses. The default value is OFF.

  • temperatureDependency (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the data depend on temperature. The default value is OFF.

  • dependencies (int, default: 0) – An Int specifying the number of field variable dependencies. The default value is 0.

  • poissonDefinition (Literal[VALUE, DEFAULT], default: DEFAULT) – A SymbolicConstant specifying whether to use the default value for the Poisson’s ratio. Possible values are:DEFAULT, specifying that the default value for the Poisson’s ratio is 0.5 in an Abaqus/Standard analysis and is obtained from the material definition in an Abaqus/Explicit analysis.VALUE, specifying that the Poisson’s ratio used in the analysis is the value provided in poisson.The default value is DEFAULT.

  • poisson (float, default: 0) – A Float specifying the Poisson’s ratio. Possible values are −1.0 ≤ poisson ≤ 0.5. This argument is valid only when poissonDefinition = VALUE. The default value is 0.5.

  • useDensity (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not to use the value of density. The default value is OFF.

  • density (float, default: 0) – A Float specifying the value of density to apply to this section. The default value is 0.0.

  • thermalStresses (tuple, default: ()) – A sequence of Floats specifying the generalized stress values caused by a unit temperature rise. Six entries must be given if the value of applyThermalStress is set to True. The default value is (“”).

  • scalingData (tuple, default: ()) – A sequence of sequences of Floats specifying the scaling factors for given temperatures and/or field data. Each row should contain (Y, alpha, T, F1,…,Fn). The default value is an empty sequence.

Returns:

A GeneralStiffnessSection object.

Return type:

GeneralStiffnessSection

HomogeneousShellSection(name, material, thickness=0, numIntPts=5, thicknessType=abaqusConstants.UNIFORM, preIntegrate=OFF, poissonDefinition=abaqusConstants.DEFAULT, poisson=0, integrationRule=abaqusConstants.SIMPSON, temperature=abaqusConstants.GRADIENT, idealization=abaqusConstants.NO_IDEALIZATION, nTemp=None, thicknessModulus=None, useDensity=OFF, density=0, thicknessField='', nodalThicknessField='')[source]

This method creates a HomogeneousShellSection object.

Note

This function can be accessed by:

mdb.models[name].parts[name].compositeLayups[i].HomogeneousShellSection
mdb.models[name].HomogeneousShellSection
session.odbs[name].HomogeneousShellSection

Note

Check HomogeneousShellSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • material (str) – A String specifying the name of the section material.

  • thickness (float, default: 0) – A Float specifying the thickness of the section. The thickness argument applies only when thicknessType = UNIFORM. The default value is 0.0.

  • numIntPts (int, default: 5) – An Int specifying the number of integration points to be used through the section. Possible values are numIntPts >> 0. The default value is 5.To use the default settings of the analysis products, set numIntPts to 5 if integrationRule = SIMPSON or set numIntPts to 7 if integrationRule = GAUSS.

  • thicknessType (Literal[UNIFORM, ANALYTICAL_FIELD, DISCRETE_FIELD, NODAL_ANALYTICAL_FIELD, NODAL_DISCRETE_FIELD], default: UNIFORM) – A SymbolicConstant specifying the distribution used for defining the thickness of the elements. Possible values are UNIFORM, ANALYTICAL_FIELD, DISCRETE_FIELD, NODAL_ANALYTICAL_FIELD, and NODAL_DISCRETE_FIELD. The default value is UNIFORM.

  • preIntegrate (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the shell section properties are specified by the user prior to the analysis (ON) or integrated during the analysis (OFF). The default value is OFF.

  • poissonDefinition (Literal[DEFAULT, VALUE], default: DEFAULT) – A SymbolicConstant specifying whether to use the default value for the Poisson’s ratio. Possible values are:DEFAULT, specifying that the default value for the Poisson’s ratio is 0.5 in an Abaqus/Standard analysis and is obtained from the material definition in an Abaqus/Explicit analysis.VALUE, specifying that the Poisson’s ratio used in the analysis is the value provided in poisson.The default value is DEFAULT.

  • poisson (float, default: 0) – A Float specifying the Poisson’s ratio. Possible values are −1.0 ≤ poisson ≤ 0.5. This argument is valid only when poissonDefinition = VALUE. The default value is 0.5.

  • integrationRule (Literal[SIMPSON, GAUSS], default: SIMPSON) – A SymbolicConstant specifying the shell section integration rule. Possible values are SIMPSON and GAUSS. The default value is SIMPSON.

  • temperature (Literal[GRADIENT, POINTWISE], default: GRADIENT) – A SymbolicConstant specifying the mode used for temperature and field variable input across the section thickness. Possible values are GRADIENT and POINTWISE. The default value is GRADIENT.

  • idealization (Literal[NO_IDEALIZATION, SMEAR_ALL_LAYERS, MEMBRANE, BENDING], default: NO_IDEALIZATION) – A SymbolicConstant specifying the mechanical idealization used for the section calculations. This member is only applicable when preIntegrate is set to ON. Possible values are NO_IDEALIZATION, SMEAR_ALL_LAYERS, MEMBRANE, and BENDING. The default value is NO_IDEALIZATION.

  • nTemp (Optional[int], default: None) – None or an Int specifying the number of temperature points to be input. This argument is valid only when temperature = POINTWISE. The default value is None.

  • thicknessModulus (Optional[float], default: None) – None or a Float specifying the effective thickness modulus. This argument is relevant only for continuum shells and must be used in conjunction with the argument poisson. The default value is None.

  • useDensity (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not to use the value of density. The default value is OFF.

  • density (float, default: 0) – A Float specifying the value of density to apply to this section. The default value is 0.0.

  • thicknessField (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object used to define the thickness of the shell elements. The thicknessField argument applies only when thicknessType = ANALYTICAL_FIELD or thicknessType = DISCRETE_FIELD. The default value is an empty string.

  • nodalThicknessField (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object used to define the thickness of the shell elements at each node. The nodalThicknessField argument applies only when thicknessType = NODAL_ANALYTICAL_FIELD or thicknessType = NODAL_DISCRETE_FIELD. The default value is an empty string.

Returns:

A HomogeneousShellSection object.

Return type:

HomogeneousShellSection

HomogeneousSolidSection(name, material, thickness=1.0)[source]

This method creates a HomogeneousSolidSection object.

Note

This function can be accessed by:

mdb.models[name].HomogeneousSolidSection
session.odbs[name].HomogeneousSolidSection

Note

Check HomogeneousSolidSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • material (str) – A String specifying the name of the material.

  • thickness (float, default: 1.0) –

    A Float specifying the thickness of the section. Possible values are None or greater than zero. The default value is 1.0.

    Changed in version 2018: The default value is now 1.0 instead of None.

Returns:

A HomogeneousSolidSection object.

Return type:

HomogeneousSolidSection

Raises:

  • InvalidNameError –

  • RangeError –

MPCSection(name, mpcType, userMode=abaqusConstants.DOF_MODE, userType=0)[source]

This method creates a MPCSection object.

Note

This function can be accessed by:

mdb.models[name].MPCSection
session.odbs[name].MPCSection

Note

Check MPCSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • mpcType (Literal[BEAM_MPC, ELBOW_MPC, PIN_MPC, LINK_MPC, TIE_MPC, USER_DEFINED]) – A SymbolicConstant specifying the MPC type of the section. Possible values are BEAM_MPC, ELBOW_MPC, PIN_MPC, LINK_MPC, TIE_MPC, and USER_DEFINED.

  • userMode (Literal[DOF_MODE, NODE_MODE], default: DOF_MODE) – A SymbolicConstant specifying the mode of the MPC when it is user-defined. Possible values are DOF_MODE and NODE_MODE. The default value is DOF_MODE.The userMode argument applies only when mpcType = USER_DEFINED.

  • userType (int, default: 0) – An Int specifying to differentiate between different constraint types in a user-defined MPCSection. The default value is 0.The userType argument applies only when mpcType = USER_DEFINED.

Returns:

A MPCSection object.

Return type:

MPCSection

Raises:

RangeError –

MembraneSection(name, material, thickness=1, thicknessType=abaqusConstants.UNIFORM, poissonDefinition=abaqusConstants.DEFAULT, poisson=0, thicknessField='')[source]

This method creates a MembraneSection object.

Note

This function can be accessed by:

mdb.models[name].MembraneSection
session.odbs[name].MembraneSection

Note

Check MembraneSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • material (str) – A String specifying the name of the material.

  • thickness (float, default: 1) – A Float specifying the thickness for the section. Possible values are thickness >> 0.0. The default value is 1.0.

  • thicknessType (Literal[UNIFORM, ANALYTICAL_FIELD, DISCRETE_FIELD], default: UNIFORM) – A SymbolicConstant specifying the distribution used for defining the thickness of the elements. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

  • poissonDefinition (Literal[DEFAULT, VALUE], default: DEFAULT) – A SymbolicConstant specifying whether to use the default value for the Poisson’s ratio. Possible values are:DEFAULT, specifying that the default value for the Poisson’s ratio is 0.5 in an Abaqus/Standard analysis and is obtained from the material definition in an Abaqus/Explicit analysis.VALUE, specifying that the Poisson’s ratio used in the analysis is the value provided in poisson.The default value is DEFAULT.

  • poisson (float, default: 0) – A Float specifying the section Poisson’s ratio. Possible values are −1.0 ≤ poisson ≤ 0.5. This argument is valid only when poissonDefinition = VALUE. The default value is 0.5.

  • thicknessField (str, default: '') – A String specifying the name of the AnalyticalField or DiscreteField object used to define the thickness of the shell elements. The thicknessField argument applies only when thicknessType = ANALYTICAL_FIELD or thicknessType = DISCRETE_FIELD. The default value is an empty string.

Returns:

A MembraneSection object.

Return type:

MembraneSection

Raises:

RangeError –

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

PEGSection(name, material, thickness=1, wedgeAngle1=0, wedgeAngle2=0)[source]

This method creates a PEGSection object.

Note

This function can be accessed by:

mdb.models[name].PEGSection
session.odbs[name].PEGSection

Note

Check PEGSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • material (str) – A String specifying the name of the material.

  • thickness (float, default: 1) – A Float specifying the thickness of the section. Possible values are thickness >> 0.0. The default value is 1.0.

  • wedgeAngle1 (float, default: 0) – A Float specifying the value of the x component of the angle between the bounding planes, ΔϕxΔ⁢ϕx. The default value is 0.0.

  • wedgeAngle2 (float, default: 0) – A Float specifying the value of the y component of the angle between the bounding planes, ΔϕyΔ⁢ϕy. The default value is 0.0.

Returns:

A PEGSection object.

Return type:

PEGSection

Raises:

  • InvalidNameError –

  • RangeError –

SurfaceSection(name, useDensity=OFF, density=0)[source]

This method creates a SurfaceSection object.

Note

This function can be accessed by:

mdb.models[name].SurfaceSection
session.odbs[name].SurfaceSection

Note

Check SurfaceSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • useDensity (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not to use the value of density. The default value is OFF.

  • density (float, default: 0) – A Float specifying the value of density to apply to this section. The default value is 0.0.

Returns:

A SurfaceSection object.

Return type:

SurfaceSection

Raises:

RangeError –

TrussSection(name, material, area=1)[source]

This method creates a TrussSection object.

Note

This function can be accessed by:

mdb.models[name].TrussSection
session.odbs[name].TrussSection

Note

Check TrussSection on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • material (str) – A String specifying the name of the material.

  • area (float, default: 1) – A Float specifying the cross-sectional area for the section. Possible values are area >> 0. The default value is 1.0.

Returns:

A TrussSection object.

Return type:

TrussSection

Raises:

RangeError –

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

SketchModel#

class SketchModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check SketchModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

ConstrainedSketch(name, sheetSize[, ...])

This method creates a ConstrainedSketch object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
ConstrainedSketch(name, sheetSize, gridSpacing=None, transform=())[source]

This method creates a ConstrainedSketch object. If the sketch cannot be created, the method returns None.

Note

This function can be accessed by:

mdb.models[name].ConstrainedSketch

Note

Check ConstrainedSketch on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • sheetSize (float) – A Float specifying the sheet size.

  • gridSpacing (Optional[float], default: None) – A Float specifying the spacing between gridlines. Possible values are Floats >> 0. The default value is approximately 2 percent of sheetSize.

  • transform (tuple, default: ()) – A sequence of sequences of Floats specifying the three-dimensional orientation of the sketch. The sequence is a 3 × 4 transformation matrix specifying the axis of rotation and the translation vector. Possible values are any Floats.The default value for the axis of rotation is the identity matrix`(1.0, 0.0, 0.0), (0.0, 1.0, 0.0), (0.0, 0.0, 1.0)`The default value for the translation vector is`(0.0, 0.0, 0.0)`The default values position the sketch on the X - Y plane centered at the origin.

Returns:

sketch – A ConstrainedSketch object.

Return type:

ConstrainedSketch

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

StepModel#

class StepModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check StepModel on help.3ds.com/2021.

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

Public Methods:

AnnealStep(name, previous[, description, ...])

This method creates an AnnealStep object.

BuckleStep(name, previous, numEigen[, ...])

This method creates a BuckleStep object.

ComplexFrequencyStep(name, previous[, ...])

This method creates a ComplexFrequencyStep object.

CoupledTempDisplacementStep(name, previous)

This method creates a CoupledTempDisplacementStep object.

CoupledThermalElectricalStructuralStep(name, ...)

This method creates a CoupledThermalElectricalStructuralStep object.

CoupledThermalElectricStep(name, previous[, ...])

This method creates a CoupledThermalElectricStep object.

DirectCyclicStep(name, previous[, ...])

This method creates a DirectCyclicStep object.

EmagTimeHarmonicStep(name, previous, ...[, ...])

This method creates a EmagTimeHarmonicStep object.

ExplicitDynamicsStep(name, previous[, ...])

This method creates an ExplicitDynamicsStep object.

FrequencyStep(name, previous, eigensolver[, ...])

This method creates a FrequencyStep object.

GeostaticStep(name, previous[, description, ...])

This method creates a GeostaticStep object.

HeatTransferStep(name, previous[, ...])

This method creates a HeatTransferStep object.

ImplicitDynamicsStep(name, previous[, ...])

This method creates an ImplicitDynamicsStep object.

MassDiffusionStep(name, previous[, ...])

This method creates a MassDiffusionStep object.

ModalDynamicsStep(name, previous[, ...])

This method creates a ModalDynamicsStep object.

RandomResponseStep(name, previous, freq[, ...])

This method creates a RandomResponseStep object.

ResponseSpectrumStep(name, previous, components)

This method creates a ResponseSpectrumStep object.

SoilsStep(name, previous[, description, ...])

This method creates a SoilsStep object.

StaticLinearPerturbationStep(name, previous)

This method creates a StaticLinearPerturbationStep object.

StaticRiksStep(name, previous[, ...])

This method creates a StaticRiksStep object.

StaticStep(name, previous[, description, ...])

This method creates a StaticStep object.

SteadyStateDirectStep(name, previous, ...[, ...])

This method creates a SteadyStateDirectStep object.

SteadyStateModalStep(name, previous, ...[, ...])

This method creates a SteadyStateModalStep object.

SteadyStateSubspaceStep(name, previous, ...)

This method creates a SteadyStateSubspaceStep object.

SubspaceDynamicsStep(name, previous[, ...])

This method creates a SubspaceDynamicsStep object.

SubstructureGenerateStep(name, previous, ...)

This method creates a SubstructureGenerateStep object.

TempDisplacementDynamicsStep(name, previous)

This method creates a TempDisplacementDynamicsStep object.

ViscoStep(name, previous[, description, ...])

This method creates a ViscoStep object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.
AnnealStep(name, previous, description='', refTemp=None, maintainAttributes=False)[source]

This method creates an AnnealStep object.

Note

This function can be accessed by:

mdb.models[name].AnnealStep

Note

Check AnnealStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • refTemp (Optional[float], default: None) – A Float specifying the post-anneal reference temperature. The default value is the current temperature at all nodes in the model after the annealing has completed.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

Returns:

step – An AnnealStep object.

Return type:

AnnealStep

BuckleStep(name, previous, numEigen, description='', eigensolver=abaqusConstants.SUBSPACE, minEigen=None, maxEigen=None, vectors=None, maxIterations=30, blockSize=abaqusConstants.DEFAULT, maxBlocks=abaqusConstants.DEFAULT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False)[source]

This method creates a BuckleStep object.

Note

This function can be accessed by:

mdb.models[name].BuckleStep

Note

Check BuckleStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • numEigen (int) – An Int specifying the number of eigenvalues to be estimated.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • eigensolver (SymbolicConstant, default: SUBSPACE) – A SymbolicConstant specifying the eigensolver. Possible values are SUBSPACE and LANCZOS. The default value is SUBSPACE.

  • minEigen (Optional[float], default: None) – None or a Float specifying the minimum eigenvalue of interest. The default value is None.

  • maxEigen (Optional[float], default: None) – None or a Float specifying the maximum eigenvalue of interest. The default value is None.

  • vectors (Optional[int], default: None) – An Int specifying the number of vectors used in the iteration. The default value is the minimum of (2*n*, n + 8), where n is the number of eigenvalues requested.

  • maxIterations (int, default: 30) – An Int specifying the maximum number of iterations. The default value is 30.

  • blockSize (SymbolicConstant, default: DEFAULT) – The SymbolicConstant DEFAULT or an Int specifying the size of the Lanczos block steps. The default value is DEFAULT.

  • maxBlocks (SymbolicConstant, default: DEFAULT) – The SymbolicConstant DEFAULT or an Int specifying the maximum number of Lanczos block steps within each Lanczos run. The default value is DEFAULT.Note:minEigen, blockSize, and maxBlocks are ignored unless eigensolver = LANCZOS.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

Returns:

step – A BuckleStep object.

Return type:

BuckleStep

ComplexFrequencyStep(name, previous, numEigen=abaqusConstants.ALL, description='', shift=None, frictionDamping=OFF, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False, minEigen=None, maxEigen=None, propertyEvaluationFrequency=None)[source]

This method creates a ComplexFrequencyStep object.

Note

This function can be accessed by:

mdb.models[name].ComplexFrequencyStep

Note

Check ComplexFrequencyStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • numEigen (SymbolicConstant, default: ALL) – The SymbolicConstant ALL or an Int specifying the number of complex eigenmodes to be calculated or a SymbolicConstant ALL. The default value is ALL.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • shift (Optional[float], default: None) – None or a Float specifying the shift point in cycles per time. The default value is None.

  • frictionDamping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • minEigen (Optional[float], default: None) – None or a Float specifying the minimum frequency of interest in cycles per time. The default value is None.

  • maxEigen (Optional[float], default: None) – None or a Float specifying the maximum frequency of interest in cycles per time. The default value is None.

  • propertyEvaluationFrequency (Optional[float], default: None) – None or a Float specifying the frequency at which to evaluate frequency-dependent properties for viscoelasticity, springs, and dashpots during the eigenvalue extraction. If the value is None, the analysis product will evaluate the stiffness associated with frequency-dependent springs and dashpots at zero frequency and will not consider the stiffness contributions from frequency-domain viscoelasticity in the step. The default value is None.

Returns:

step – A ComplexFrequencyStep object.

Return type:

ComplexFrequencyStep

CoupledTempDisplacementStep(name, previous, description='', response=abaqusConstants.TRANSIENT, timePeriod=1, nlgeom=OFF, stabilizationMethod=abaqusConstants.NONE, stabilizationMagnitude=None, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None, deltmx=0, cetol=0, creepIntegration=abaqusConstants.IMPLICIT, solutionTechnique=abaqusConstants.FULL_NEWTON, matrixStorage=abaqusConstants.SOLVER_DEFAULT, amplitude=abaqusConstants.STEP, extrapolation=abaqusConstants.LINEAR, maintainAttributes=False, convertSDI=abaqusConstants.PROPAGATED, adaptiveDampingRatio=0, continueDampingFactors=OFF)[source]

This method creates a CoupledTempDisplacementStep object.

Note

This function can be accessed by:

mdb.models[name].CoupledTempDisplacementStep

Note

Check CoupledTempDisplacementStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • response (SymbolicConstant, default: TRANSIENT) – A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

  • timePeriod (float, default: 1) – A Float specifying the total time period for the step. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.

  • stabilizationMethod (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

  • stabilizationMagnitude (Optional[float], default: None) – A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable and stabilizationMethod ≠ NONE. The default value is 2×10-4.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • deltmx (float, default: 0) – A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.

  • cetol (float, default: 0) – A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

  • creepIntegration (SymbolicConstant, default: IMPLICIT) – A SymbolicConstant specifying the type of integration to be used for creep and swelling effects throughout the step. Possible values are IMPLICIT, EXPLICIT, and NONE. The default value is IMPLICIT.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the type of solution technique. Possible values are FULL_NEWTON and SEPARATED. The default value is FULL_NEWTON.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

  • adaptiveDampingRatio (float, default: 0) – A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

  • continueDampingFactors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step – A CoupledTempDisplacementStep object.

Return type:

CoupledTempDisplacementStep

CoupledThermalElectricStep(name, previous, description='', response=abaqusConstants.TRANSIENT, timePeriod=1, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None, end=abaqusConstants.PERIOD, deltmx=0, mxdem=0, solutionTechnique=abaqusConstants.FULL_NEWTON, matrixStorage=abaqusConstants.SOLVER_DEFAULT, amplitude=abaqusConstants.STEP, extrapolation=abaqusConstants.LINEAR, maintainAttributes=False, convertSDI=abaqusConstants.PROPAGATED)[source]

This method creates a CoupledThermalElectricStep object.

Note

This function can be accessed by:

mdb.models[name].CoupledThermalElectricStep

Note

Check CoupledThermalElectricStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • response (SymbolicConstant, default: TRANSIENT) – A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

  • timePeriod (float, default: 1) – A Float specifying the total time period for the step. The default value is 1.0.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • end (SymbolicConstant, default: PERIOD) – A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.

  • deltmx (float, default: 0) – A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.

  • mxdem (float, default: 0) – A Float specifying the maximum allowable emissivity change with temperature and field variables during an increment. The default value is 0.1.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the type of solution technique. Possible values are FULL_NEWTON and SEPARATED. The default value is FULL_NEWTON.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

Returns:

step – A CoupledThermalElectricStep object.

Return type:

CoupledThermalElectricStep

CoupledThermalElectricalStructuralStep(name, previous, description='', response=abaqusConstants.TRANSIENT, timePeriod=1, nlgeom=OFF, stabilizationMethod=abaqusConstants.NONE, stabilizationMagnitude=None, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None, deltmx=0, cetol=0, creepIntegration=abaqusConstants.IMPLICIT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, amplitude=abaqusConstants.STEP, extrapolation=abaqusConstants.LINEAR, maintainAttributes=False, convertSDI=abaqusConstants.PROPAGATED, adaptiveDampingRatio=0, continueDampingFactors=OFF)[source]

This method creates a CoupledThermalElectricalStructuralStep object.

Note

This function can be accessed by:

mdb.models[name].CoupledThermalElectricalStructuralStep

Note

Check CoupledThermalElectricalStructuralStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • response (SymbolicConstant, default: TRANSIENT) – A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

  • timePeriod (float, default: 1) – A Float specifying the total time period for the step. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.

  • stabilizationMethod (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

  • stabilizationMagnitude (Optional[float], default: None) – A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable and stabilizationMethod ≠ NONE. The default value is 2×10-4.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • deltmx (float, default: 0) – A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.

  • cetol (float, default: 0) – A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

  • creepIntegration (SymbolicConstant, default: IMPLICIT) – A SymbolicConstant specifying the type of integration to be used for creep and swelling effects throughout the step. Possible values are IMPLICIT, EXPLICIT, and NONE. The default value is IMPLICIT.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

  • adaptiveDampingRatio (float, default: 0) – A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

  • continueDampingFactors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step – A CoupledThermalElectricalStructuralStep object.

Return type:

CoupledThermalElectricalStructuralStep

DirectCyclicStep(name, previous, description='', timePeriod=1, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None, maxNumIterations=200, initialTerms=11, maxTerms=25, termsIncrement=5, deltmx=0, cetol=0, timePoints=abaqusConstants.NONE, fatigue=OFF, continueAnalysis=OFF, minCycleInc=100, maxCycleInc=1000, maxNumCycles=abaqusConstants.DEFAULT, damageExtrapolationTolerance=1, matrixStorage=abaqusConstants.SOLVER_DEFAULT, extrapolation=abaqusConstants.LINEAR, maintainAttributes=False, convertSDI=abaqusConstants.PROPAGATED)[source]

This method creates a DirectCyclicStep object.

Note

This function can be accessed by:

mdb.models[name].DirectCyclicStep

Note

Check DirectCyclicStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • timePeriod (float, default: 1) – A Float specifying the time of single loading cycle. The default value is 1.0.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • maxNumIterations (int, default: 200) – An Int specifying the maximum number of iterations in a step. The default value is 200.

  • initialTerms (int, default: 11) – An Int specifying the initial number of terms in the Fourier series. The default value is 11.

  • maxTerms (int, default: 25) – An Int specifying the maximum number of terms in the Fourier series. The default value is 25.

  • termsIncrement (int, default: 5) – An Int specifying the increment in number of terms in the Fourier series. The default value is 5.

  • deltmx (float, default: 0) – A Float specifying the maximum temperature change to be allowed in an increment. The default value is 0.0.

  • cetol (float, default: 0) – A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

  • timePoints (str, default: NONE) – None or a String specifying a String specifying the name of a time point object used to determine at which times the response of the structure will be evaluated. The default value is NONE.

  • fatigue (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include low-cycle fatigue analysis. The default value is OFF.

  • continueAnalysis (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the displacement solution in the Fourier series obtained in the previous direct cyclic step is used as the starting values for the current step. The default value is OFF.

  • minCycleInc (int, default: 100) – An Int specifying the minimum number of cycles over which the damage is extrapolated forward. The default value is 100.

  • maxCycleInc (int, default: 1000) – An Int specifying the maximum number of cycles over which the damage is extrapolated forward. The default value is 1000.

  • maxNumCycles (SymbolicConstant, default: DEFAULT) – The SymbolicConstant DEFAULT or an Int specifying the maximum number of cycles allowed in a step or DEFAULT. A value of 1 plus half of the maximum number of cycles will be used if DEFAULT is specified. The default value is DEFAULT.

  • damageExtrapolationTolerance (float, default: 1) – A Float specifying the maximum extrapolated damage increment. The default value is 1.0.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

Returns:

step – A DirectCyclicStep object.

Return type:

DirectCyclicStep

EmagTimeHarmonicStep(name, previous, frequencyRange, description='', factorization=abaqusConstants.COMPLEX)[source]

This method creates a EmagTimeHarmonicStep object.

Note

This function can be accessed by:

mdb.models[name].EmagTimeHarmonicStep

Note

Check EmagTimeHarmonicStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • frequencyRange (List[EmagTimeHarmonicFrequency]) – An EmagTimeHarmonicFrequencyArray object.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • factorization (SymbolicConstant, default: COMPLEX) – A SymbolicConstant specifying whether damping terms are to be ignored so that a real, rather than a complex, system matrix is factored. Possible values are REAL_ONLY and COMPLEX. The default value is COMPLEX.

Returns:

step – An EmagTimeHarmonicStep object.

Return type:

EmagTimeHarmonicStep

ExplicitDynamicsStep(name, previous, description='', timePeriod=1, nlgeom=ON, adiabatic=OFF, timeIncrementationMethod=abaqusConstants.AUTOMATIC_GLOBAL, maxIncrement=None, scaleFactor=1, massScaling=abaqusConstants.PREVIOUS_STEP, linearBulkViscosity=0, quadBulkViscosity=1, userDefinedInc=None, maintainAttributes=False, improvedDtMethod=ON)[source]

This method creates an ExplicitDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].ExplicitDynamicsStep

Note

Check ExplicitDynamicsStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • timePeriod (float, default: 1) – A Float specifying the total time period for the step. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is ON.

  • adiabatic (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that an adiabatic stress analysis is to be performed. The default value is OFF.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC_GLOBAL) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are AUTOMATIC_GLOBAL, AUTOMATIC_EBE, FIXED_USER_DEFINED_INC, and FIXED_EBE. The default value is AUTOMATIC_GLOBAL.

  • maxIncrement (Optional[float], default: None) – None or a Float specifying the maximum time increment. If there is no upper limit, maxIncrement = None. This argument is required only when timeIncrementationMethod = AUTOMATIC_GLOBAL or AUTOMATIC_EBE. The default value is None.

  • scaleFactor (float, default: 1) – A Float specifying the factor that is used to scale the time increment. This argument is required only when timeIncrementationMethod = AUTOMATIC_GLOBAL, AUTOMATIC_EBE, or FIXED_EBE. The default value is 1.0.

  • massScaling (List[MassScaling], default: PREVIOUS_STEP) – A MassScalingArray object specifying mass scaling controls. The default value is PREVIOUS_STEP.

  • linearBulkViscosity (float, default: 0) – A Float specifying the linear bulk viscosity parameter, b1b1. The default value is 0.06.

  • quadBulkViscosity (float, default: 1) – A Float specifying the quadratic bulk viscosity parameter, b2b2. The default value is 1.2.

  • userDefinedInc (Optional[float], default: None) – None or a Float specifying the user-defined time increment. This argument is required only when timeIncrementationMethod = FIXED_USER_DEFINED_INC. The default value is None.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • improvedDtMethod (Union[AbaqusBoolean, bool], default: ON) –

    A Boolean specifying whether to use the “improved” (improvedDtMethod = ON) or “conservative” (improvedDtMethod = OFF) method to estimate the element stable time increment for three-dimensional continuum elements and elements with plane stress formulations (shell, membrane, and two-dimensional plane stress elements). The default value is ON.

    New in version 2018: The improvedDtMethod argument was added.

Returns:

step – An ExplicitDynamicsStep object.

Return type:

ExplicitDynamicsStep

FrequencyStep(name, previous, eigensolver, numEigen=abaqusConstants.ALL, description='', shift=0, minEigen=None, maxEigen=None, vectors=None, maxIterations=30, blockSize=abaqusConstants.DEFAULT, maxBlocks=abaqusConstants.DEFAULT, normalization=abaqusConstants.DISPLACEMENT, propertyEvaluationFrequency=None, projectDamping=ON, acousticCoupling=abaqusConstants.AC_ON, acousticRangeFactor=1, frictionDamping=OFF, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False, simLinearDynamics=OFF, residualModes=OFF, substructureCutoffMultiplier=5, firstCutoffMultiplier=1, secondCutoffMultiplier=1, residualModeRegion=None, residualModeDof=None, limitSavedEigenvectorRegion=None)[source]

This method creates a FrequencyStep object.

Note

This function can be accessed by:

mdb.models[name].FrequencyStep

Note

Check FrequencyStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • eigensolver (SymbolicConstant) – A SymbolicConstant specifying the eigensolver. Possible values are LANCZOS, SUBSPACE, and AMS.The following optional arguments are ignored unless eigensolver = LANCZOS: blockSize, maxBlocks, normalization, propertyEvaluationFrequency.The following optional arguments are ignored unless eigensolver = LANCZOS or AMS: minEigen, maxEigen, and acousticCoupling.The following optional arguments are ignored unless eigensolver = AMS: projectDamping, acousticRangeFactor, substructureCutoffMultiplier, firstCutoffMultiplier, secondCutoffMultiplier, residualModeRegion, regionalModeDof, and limitSavedEigenvectorRegion.

  • numEigen (SymbolicConstant, default: ALL) – The SymbolicConstant ALL or an Int specifying the number of eigenvalues to be calculated or ALL. The default value is ALL.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • shift (float, default: 0) – A Float specifying the shift point in cycles per time. The default value is 0.0.

  • minEigen (Optional[float], default: None) – None or a Float specifying the minimum frequency of interest in cycles per time. The default value is None.

  • maxEigen (Optional[float], default: None) – None or a Float specifying the maximum frequency of interest in cycles per time. The default value is None.

  • vectors (Optional[int], default: None) – None or an Int specifying the number of vectors used in the iteration. The default is the minimum of (2*n*, n + 8), where n is the number of eigenvalues requested. The default value is None.

  • maxIterations (int, default: 30) – An Int specifying the maximum number of iterations. The default value is 30.

  • blockSize (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the size of the Lanczos block steps. The default value is DEFAULT.

  • maxBlocks (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the maximum number of Lanczos block steps within each Lanczos run. The default value is DEFAULT.

  • normalization (SymbolicConstant, default: DISPLACEMENT) – A SymbolicConstant specifying the method for normalizing eigenvectors. Possible values are DISPLACEMENT and MASS. The default value is DISPLACEMENT.A value of DISPLACEMENT indicates normalizing the eigenvectors so that the largest displacement entry in each vector is unity. A value of MASS indicates normalizing the eigenvectors with respect to the structure’s mass matrix, which results in scaling the eigenvectors so that the generalized mass for each vector is unity.

  • propertyEvaluationFrequency (Optional[float], default: None) – None or a Float specifying the frequency at which to evaluate frequency-dependent properties for viscoelasticity, springs, and dashpots during the eigenvalue extraction. If the value is None, the analysis product will evaluate the stiffness associated with frequency-dependent springs and dashpots at zero frequency and will not consider the stiffness contributions from frequency-domain viscoelasticity in the step. The default value is None.

  • projectDamping (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to include projection of viscous and structural damping operators during AMS eigenvalue extraction. Valid only when eigenSolver = AMS. The default value is ON.

  • acousticCoupling (SymbolicConstant, default: AC_ON) – A SymbolicConstant specifying the type of acoustic-structural coupling in models with acoustic and structural elements coupled using the TIE option or in models with ASI-type elements. Possible values are AC_ON, AC_OFF, and AC_PROJECTION. The default value is AC_ON.

  • acousticRangeFactor (float, default: 1) – A Float specifying the ratio of the maximum acoustic frequency to the maximum structural frequency. The default value is 1.0.

  • frictionDamping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • simLinearDynamics (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to activate the SIM-based linear dynamics procedures. The default value is OFF.

  • residualModes (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include residual modes from an immediately preceding Static, Linear Perturbation step. The default value is OFF.

  • substructureCutoffMultiplier (float, default: 5) – A Float specifying the cutoff frequency for substructure eigenproblems, defined as a multiplier of the maximum frequency of interest. The default value is 5.0.

  • firstCutoffMultiplier (float, default: 1) – A Float specifying the first cutoff frequency for a reduced eigenproblem, defined as a multiplier of the maximum frequency of interest. The default value is 1.7.

  • secondCutoffMultiplier (float, default: 1) – A Float specifying the second cutoff frequency for a reduced eigenproblem defined as a multiplier of the maximum frequency of interest. The default value is 1.1.

  • residualModeRegion (Optional[str], default: None) – None or a sequence of Strings specifying the name of a region for which residual modes are requested. The default value is None.

  • residualModeDof (Optional[str], default: None) – None or a sequence of Ints specifying the degree of freedom for which residual modes are requested. The default value is None.

  • limitSavedEigenvectorRegion (Optional[SymbolicConstant], default: None) – None or a Region object specifying a region for which eigenvectors should be saved or the SymbolicConstant None representing the whole model. The default value is None.

Returns:

step – A FrequencyStep object.

Return type:

FrequencyStep

GeostaticStep(name, previous, description='', nlgeom=OFF, matrixSolver=abaqusConstants.DIRECT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False, solutionTechnique=abaqusConstants.FULL_NEWTON, reformKernel=8, convertSDI=abaqusConstants.PROPAGATED, utol=None, timePeriod=1, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None)[source]

This method creates a GeostaticStep object.

Note

This function can be accessed by:

mdb.models[name].GeostaticStep

Note

Check GeostaticStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.

  • matrixSolver (SymbolicConstant, default: DIRECT) – A SymbolicConstant specifying the type of solver. Possible values are DIRECT and ITERATIVE. The default value is DIRECT.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the technique used to for solving nonlinear equations. Possible values are FULL_NEWTON and QUASI_NEWTON. The default value is FULL_NEWTON.

  • reformKernel (int, default: 8) – An Int specifying the number of quasi-Newton iterations allowed before the kernel matrix is reformed.. The default value is 8.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

  • utol (Optional[float], default: None) – None or a Float specifying the tolerance for maximum change of displacements. The default value is None.

  • timePeriod (float, default: 1) – A Float specifying the total time period. The default value is 1.0.Note:This parameter is ignored unless timeIncrementationMethod = AUTOMATIC.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) –

    An Int specifying the maximum number of increments in a step. The default value is 100.

    New in version 2017: The maxNumInc attribute was added to the GeostaticStep class.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.Note:This parameter is ignored unless timeIncrementationMethod = AUTOMATIC.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.Note:This parameter is ignored unless timeIncrementationMethod = AUTOMATIC.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.Note:This parameter is ignored unless timeIncrementationMethod = AUTOMATIC.

Returns:

step – A GeostaticStep object.

Return type:

GeostaticStep

HeatTransferStep(name, previous, description='', response=abaqusConstants.TRANSIENT, timePeriod=1, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None, end=None, deltmx=0, mxdem=0, amplitude=abaqusConstants.STEP, extrapolation=abaqusConstants.LINEAR, matrixSolver=abaqusConstants.DIRECT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False, solutionTechnique=abaqusConstants.FULL_NEWTON, reformKernel=8, convertSDI=abaqusConstants.PROPAGATED)[source]

This method creates a HeatTransferStep object.

Note

This function can be accessed by:

mdb.models[name].HeatTransferStep

Note

Check HeatTransferStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • response (SymbolicConstant, default: TRANSIENT) – A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

  • timePeriod (float, default: 1) – A Float specifying the total time period. The default value is 1.0.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of 0.8 times the initial time increment or 10−5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • end (Optional[float], default: None) – None or a Float specifying the temperature change rate (temperature per time) used to define steady state. When all nodal temperatures are changing at less than this rate, the solution terminates. The default value is None.Note:This parameter is ignored unless response = STEADY_STATE.

  • deltmx (float, default: 0) – A Float specifying the maximum temperature change to be allowed in an increment during a transient heat transfer analysis. The default value is 0.0.

  • mxdem (float, default: 0) – A Float specifying the maximum allowable emissivity change with temperature and field variables during an increment. The default value is 0.1.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default is STEP. Possible values are STEP and RAMP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • matrixSolver (SymbolicConstant, default: DIRECT) – A SymbolicConstant specifying the type of solver. Possible values are DIRECT and ITERATIVE. The default value is DIRECT.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the technique used to for solving nonlinear equations. Possible values are FULL_NEWTON and QUASI_NEWTON. The default value is FULL_NEWTON.

  • reformKernel (int, default: 8) – An Int specifying the number of quasi-Newton iterations allowed before the kernel matrix is reformed.. The default value is 8.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

Returns:

step – A HeatTransferStep object.

Return type:

HeatTransferStep

ImplicitDynamicsStep(name, previous, description='', timePeriod=1, nlgeom=OFF, matrixStorage=abaqusConstants.SOLVER_DEFAULT, application=abaqusConstants.ANALYSIS_PRODUCT_DEFAULT, adiabatic=OFF, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=abaqusConstants.DEFAULT, hafTolMethod=abaqusConstants.VALUE, haftol=None, halfIncScaleFactor=None, nohaf=OFF, amplitude=abaqusConstants.STEP, alpha=abaqusConstants.DEFAULT, initialConditions=abaqusConstants.DEFAULT, extrapolation=abaqusConstants.ANALYSIS_PRODUCT_DEFAULT, noStop=OFF, maintainAttributes=False, solutionTechnique=abaqusConstants.FULL_NEWTON, reformKernel=8, convertSDI=abaqusConstants.PROPAGATED)[source]

This method creates an ImplicitDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].ImplicitDynamicsStep

Note

Check ImplicitDynamicsStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • timePeriod (float, default: 1) – A Float specifying the total time period of the step. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is based on the previous step.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • application (SymbolicConstant, default: ANALYSIS_PRODUCT_DEFAULT) – A SymbolicConstant specifying the application type of the step. Possible values are ANALYSIS_PRODUCT_DEFAULT, TRANSIENT_FIDELITY, MODERATE_DISSIPATION, and QUASI_STATIC. The default value is ANALYSIS_PRODUCT_DEFAULT.

  • adiabatic (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an adiabatic stress analysis is to be performed. The default value is OFF.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.

  • maxInc (Union[SymbolicConstant, float], default: DEFAULT) – The SymbolicConstant DEFAULT or a Float specifying the maximum time increment allowed.

  • hafTolMethod (SymbolicConstant, default: VALUE) – A SymbolicConstant specifying the way of specifying half-increment residual tolerance with the automatic time incrementation scheme. Possible values are ANALYSIS_PRODUCT_DEFAULT, VALUE, and SCALE. The default value is VALUE.

  • haftol (Optional[float], default: None) – None or a Float specifying the half-increment residual tolerance to be used with the automatic time incrementation scheme. The default value is None.

  • halfIncScaleFactor (Optional[float], default: None) – None or a Float specifying the half-increment residual tolerance scale factor to be used with the automatic time incrementation scheme. The default value is None.

  • nohaf (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to suppress calculation of the half-increment residual. The default value is OFF.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.

  • alpha (Union[SymbolicConstant, float], default: DEFAULT) – The SymbolicConstant DEFAULT or a Float specifying the nondefault value of the numerical (artificial) damping control parameter, αα, in the implicit operator. Possible values are −.333 <α<<α< 0. The default value is DEFAULT.

  • initialConditions (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying whether accelerations should be calculated or recalculated at the beginning of the step. Possible values are DEFAULT, BYPASS, and ALLOW. The default value is DEFAULT.

  • extrapolation (SymbolicConstant, default: ANALYSIS_PRODUCT_DEFAULT) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, PARABOLIC, VELOCITY_PARABOLIC, and ANALYSIS_PRODUCT_DEFAULT. The default value is ANALYSIS_PRODUCT_DEFAULT.

  • noStop (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed have been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set noStop = OFF only in special cases when you have a thorough understanding of how to interpret the results.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the technique used to for solving nonlinear equations. Possible values are FULL_NEWTON and QUASI_NEWTON. The default value is FULL_NEWTON.

  • reformKernel (int, default: 8) – An Int specifying the number of quasi-Newton iterations allowed before the kernel matrix is reformed.. The default value is 8.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

Returns:

step – An ImplicitDynamicsStep object.

Return type:

ImplicitDynamicsStep

MassDiffusionStep(name, previous, description='', response=abaqusConstants.TRANSIENT, timePeriod=1, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None, end=abaqusConstants.PERIOD, dcmax=0, amplitude=abaqusConstants.STEP, extrapolation=abaqusConstants.LINEAR, maintainAttributes=False, convertSDI=abaqusConstants.PROPAGATED)[source]

This method creates a MassDiffusionStep object.

Note

This function can be accessed by:

mdb.models[name].MassDiffusionStep

Note

Check MassDiffusionStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • response (SymbolicConstant, default: TRANSIENT) – A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

  • timePeriod (float, default: 1) – A Float specifying the total time period. The default value is 1.0.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of 0.8 times the initial time increment or 10−5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • end (SymbolicConstant, default: PERIOD) – A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.

  • dcmax (float, default: 0) – A Float specifying the maximum normalized concentration change to be allowed in an increment. The default value is 0.0.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default is STEP. Possible values are STEP and RAMP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

Returns:

step – A MassDiffusionStep object.

Return type:

MassDiffusionStep

ModalDynamicsStep(name, previous, description='', continueAnalysis=OFF, timePeriod=1, incSize=1, directDamping=None, compositeDamping=None, rayleighDamping=None, amplitude=abaqusConstants.STEP, maintainAttributes=False, directDampingByFrequency=None, rayleighDampingByFrequency=None)[source]

This method creates a ModalDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].ModalDynamicsStep

Note

Check ModalDynamicsStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • continueAnalysis (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step starts with zero initial conditions. The default value is OFF.

  • timePeriod (float, default: 1) – A Float specifying the total time period. The default value is 1.0.

  • incSize (float, default: 1) – A Float specifying the time increment to be used. The default value is 1.0.

  • directDamping (Optional[DirectDamping], default: None) – A DirectDamping object.

  • compositeDamping (Optional[CompositeDamping], default: None) – A CompositeDamping object.

  • rayleighDamping (Optional[RayleighDamping], default: None) – A RayleighDamping object.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • directDampingByFrequency (Optional[DirectDampingByFrequency], default: None) – A DirectDampingByFrequency object.

  • rayleighDampingByFrequency (Optional[RayleighDampingByFrequency], default: None) – A RayleighDampingByFrequency object.

Returns:

step – A ModalDynamicsStep object.

Return type:

ModalDynamicsStep

ModelFromInputFile(name, inputFileName)[source]

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromInputFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the input file (including the .inp extension) to be parsed into the new model. This String can also be the full path to the input file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

ModelFromNastranFile(modelName, inputFileName, sectionConsolidation=abaqusConstants.PRESERVE_SECTION, preIntegratedShell=OFF, weightMassScaling=ON, loadCases=ON, coupleBeamOffsets=ON, cbar=abaqusConstants.B31, cquad4=abaqusConstants.S4, chexa=abaqusConstants.C3D8I, ctetra=abaqusConstants.C3D10, keepTranslatedFiles=ON)[source]

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects. The default values is discussed in following and can be defined alternatively in the Abaqus environment file as the one used for the translator from Nastran to Abaqus. For more information, see Translating Nastran data to Abaqus files.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromNastranFile on help.3ds.com/2021.

Parameters:

  • modelName (str) – A String specifying the repository key.

  • inputFileName (str) – A String specifying the name of the Nastran input file (including the .bdf, .dat, .nas, .nastran, .blk, .bulk extension) to be read into the new model. This String can also be the full path to the Nastran input file if it is located in another directory.

  • sectionConsolidation (SymbolicConstant, default: PRESERVE_SECTION) – A SymbolicConstant specifying the method used to create shell section. Possible values are PRESERVE_SECTION, GROUP_BY_MATERIAL, and NONE. If PRESERVE_SECTION is used, an Abaqus section is created corresponding to each shell property ID. If GROUP_BY_MATERIAL is used, a single Abaqus section is created for all homogeneous elements referencing the same material. In both cases, material orientations and offsets are created using discrete fields. If NONE is used, a separate shell section is created for each combination of orientation, material offset, and/or thickness. The default is PRESERVE_SECTION.

  • preIntegratedShell (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the pre-integrated shell section is created in default for shell element. The default value is OFF.

  • weightMassScaling (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the value on the Nastran data line PARAM, WTMASS is used as a multiplier for all density, mass, and rotary inertia values created in the Abaqus input file. The default value is ON.

  • loadCases (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether each SUBCASE for linear static analyses is translated to a LOAD CASE option, and all such LOAD CASE options are grouped in a single STEP option. The default value is ON.

  • coupleBeamOffsets (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to translate the beam element connectivity to newly created nodes at the offset location and rigidly coupling the new and original nodes. If not, beam element offsets are translated to the CENTROID and SHEAR CENTER options, which are suboptions of the BEAM GENERAL SECTION option. The default value is ON. When the beam element references a PBARL or PBEAML property or if the beam offset has a significant component in the direction of the beam axis, the setting for this argument is always ON.

  • cbar (str, default: B31) – A String specifying the 2-node beam that is created from CBAR and CBEAM elements. Possible values are B31 and B33. The default is B31.

  • cquad4 (str, default: S4) – A String specifying the 4-node shell that is created from CQUAD4 elements. Possible values are S4 and S4R. The default is S4. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • chexa (str, default: C3D8I) – A String specifying the 8-node brick that is created from CHEXA elements. Possible values are C3D8I, C3D8 and C3D8R. The default is C3D8I. If a reduced-integration element is chosen, the enhanced hourglass formulation is applied automatically.

  • ctetra (str, default: C3D10) – A String specifying the 10-node tetrahedron that is created from CTETRA elements. Possible values are C3D10 and C3D10M. The default is C3D10.

  • keepTranslatedFiles (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to keep the generated Abaqus input file after the model is created from the Nastran input file. The default value is ON.

Returns:

A Model object.

Return type:

Model

ModelFromOdbFile(name, odbFileName)[source]

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

Note

This function can be accessed by:

mdb.Model

Note

Check ModelFromOdbFile on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • odbFileName (str) – A String specifying the name of the output database file (including the .odb extension) to be read into the new model. This String can also be the full path to the output database file if it is located in another directory.

Returns:

A Model object.

Return type:

Model

RandomResponseStep(name, previous, freq, description='', scale=abaqusConstants.LOG, directDamping=None, compositeDamping=None, rayleighDamping=None, structuralDamping=None, directDampingByFrequency=None, rayleighDampingByFrequency=None, structuralDampingByFrequency=None, maintainAttributes=False)[source]

This method creates a RandomResponseStep object.

Note

This function can be accessed by:

mdb.models[name].RandomResponseStep

Note

Check RandomResponseStep on help.3ds.com/2021.

Parameters:
Returns:

step – A RandomResponseStep object.

Return type:

RandomResponseStep

ResponseSpectrumStep(name, previous, components, description='', comp=abaqusConstants.SINGLE_DIRECTION, sum=abaqusConstants.ABS, directDamping=None, compositeDamping=None, rayleighDamping=None, directDampingByFrequency=None, rayleighDampingByFrequency=None, maintainAttributes=False)[source]

This method creates a ResponseSpectrumStep object.

Note

This function can be accessed by:

mdb.models[name].ResponseSpectrumStep

Note

Check ResponseSpectrumStep on help.3ds.com/2021.

Parameters:
Returns:

step – A ResponseSpectrumStep object.

Return type:

ResponseSpectrumStep

SoilsStep(name, previous, description='', response=abaqusConstants.TRANSIENT, timePeriod=1, nlgeom=OFF, stabilizationMethod=abaqusConstants.NONE, stabilizationMagnitude=None, creep=ON, timeIncrementationMethod=abaqusConstants.AUTOMATIC, initialInc=None, minInc=None, maxInc=None, maxNumInc=100, end=abaqusConstants.PERIOD, utol=None, cetol=0, amplitude=abaqusConstants.STEP, extrapolation=abaqusConstants.LINEAR, matrixSolver=abaqusConstants.DIRECT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False, solutionTechnique=abaqusConstants.FULL_NEWTON, reformKernel=8, convertSDI=abaqusConstants.PROPAGATED, adaptiveDampingRatio=0, continueDampingFactors=OFF)[source]

This method creates a SoilsStep object.

Note

This function can be accessed by:

mdb.models[name].SoilsStep

Note

Check SoilsStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • response (SymbolicConstant, default: TRANSIENT) – A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

  • timePeriod (float, default: 1) – A Float specifying the total time period. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.

  • stabilizationMethod (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

  • stabilizationMagnitude (Optional[float], default: None) – A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10-4.

  • creep (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether a creep response occurs during this step. The default value is ON.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • end (SymbolicConstant, default: PERIOD) – A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.

  • utol (Optional[float], default: None) – None or a Float specifying the maximum pore pressure change permitted in any increment (in pressure units) in a transient consolidation analysis. The default value is None.

  • cetol (float, default: 0) – A Float specifying the maximum allowable difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • matrixSolver (SymbolicConstant, default: DIRECT) – A SymbolicConstant specifying the type of solver. Possible values are DIRECT and ITERATIVE. The default value is DIRECT.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the technique used to for solving nonlinear equations. Possible values are FULL_NEWTON and QUASI_NEWTON. The default value is FULL_NEWTON.

  • reformKernel (int, default: 8) – An Int specifying the number of quasi-Newton iterations allowed before the kernel matrix is reformed.. The default value is 8.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

  • adaptiveDampingRatio (float, default: 0) – A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

  • continueDampingFactors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step – A SoilsStep object.

Return type:

SoilsStep

StaticLinearPerturbationStep(name, previous, description='', matrixSolver=abaqusConstants.DIRECT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False)[source]

This method creates a StaticLinearPerturbationStep object.

Note

This function can be accessed by:

mdb.models[name].StaticLinearPerturbationStep

Note

Check StaticLinearPerturbationStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • matrixSolver (SymbolicConstant, default: DIRECT) – A SymbolicConstant specifying the type of solver. Possible values are DIRECT and ITERATIVE. The default value is DIRECT.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

Returns:

step – A StaticLinearPerturbationStep object.

Return type:

StaticLinearPerturbationStep

StaticRiksStep(name, previous, description='', nlgeom=OFF, adiabatic=OFF, maxLPF=None, nodeOn=OFF, maximumDisplacement=0, dof=0, region=None, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, totalArcLength=1, initialArcInc=None, minArcInc=None, maxArcInc=None, matrixStorage=abaqusConstants.SOLVER_DEFAULT, extrapolation=abaqusConstants.LINEAR, fullyPlastic='', noStop=OFF, maintainAttributes=False, useLongTermSolution=OFF, convertSDI=abaqusConstants.PROPAGATED)[source]

This method creates a StaticRiksStep object.

Note

This function can be accessed by:

mdb.models[name].StaticRiksStep

Note

Check StaticRiksStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.

  • adiabatic (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to perform an adiabatic stress analysis. The default value is OFF.

  • maxLPF (Optional[float], default: None) – None or a Float specifying the maximum value of the load proportionality factor. The default value is None.

  • nodeOn (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to monitor the finishing displacement value at a node. The default value is OFF.

  • maximumDisplacement (float, default: 0) – A Float specifying the value of the total displacement (or rotation) at the node and degree of freedom that, if crossed during an increment, ends the step at the current increment. This argument is required when nodeOn = ON. The default value is 0.0.

  • dof (int, default: 0) – An Int specifying the degree of freedom being monitored. This argument is required when nodeOn = ON. The default value is 0.

  • region (Optional[Region], default: None) – A Region object specifying the vertex at which the finishing displacement value is being monitored. This argument is required when nodeOn = ON.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • totalArcLength (float, default: 1) – A Float specifying the total load proportionality factor associated with the load in this step. The default value is 1.0.

  • initialArcInc (Optional[float], default: None) – A Float specifying the initial load proportionality factor. The default value is the total load proportionality factor for the step.

  • minArcInc (Optional[float], default: None) – A Float specifying the minimum arc length increment allowed. The default value is the smaller of the suggested initial load proportionality factor or 10−5 times the total load proportionality factor for the step.

  • maxArcInc (Optional[float], default: None) – A Float specifying the maximum arc length increment allowed. The default value is the total load proportionality factor for the step.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • fullyPlastic (str, default: '') – A String specifying the name of the region being monitored for fully Plastic behavior. The default value is an empty string.

  • noStop (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed have been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set noStop = ON only in special cases when you have a thorough understanding of how to interpret the results.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • useLongTermSolution (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying wether to obtain the fully relaxed long-term elastic solution with time-domain viscoelasticity or the long-term elastic-Plastic solution for two-layer viscoplasticity. The default value is OFF.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

Returns:

step – A StaticRiksStep object.

Return type:

StaticRiksStep

StaticStep(name, previous, description='', timePeriod=1, nlgeom=OFF, stabilizationMethod=abaqusConstants.NONE, stabilizationMagnitude=None, adiabatic=OFF, timeIncrementationMethod=abaqusConstants.AUTOMATIC, maxNumInc=100, initialInc=None, minInc=None, maxInc=None, matrixSolver=abaqusConstants.DIRECT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, amplitude=abaqusConstants.RAMP, extrapolation=abaqusConstants.LINEAR, fullyPlastic='', noStop=OFF, maintainAttributes=False, useLongTermSolution=OFF, solutionTechnique=abaqusConstants.FULL_NEWTON, reformKernel=8, convertSDI=abaqusConstants.PROPAGATED, adaptiveDampingRatio=0, continueDampingFactors=OFF)[source]

This method creates a StaticStep object.

Note

This function can be accessed by:

mdb.models[name].StaticStep

Note

Check StaticStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • timePeriod (float, default: 1) – A Float specifying the total time period. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.

  • stabilizationMethod (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

  • stabilizationMagnitude (Optional[float], default: None) – A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10-4.

  • adiabatic (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to perform an adiabatic stress analysis. The default value is OFF.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10-5 times the total time period.

  • maxInc (Optional[float], default: None) – A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

  • matrixSolver (SymbolicConstant, default: DIRECT) – A SymbolicConstant specifying the type of solver. Possible values are DIRECT and ITERATIVE. The default value is DIRECT.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • amplitude (SymbolicConstant, default: RAMP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is RAMP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • fullyPlastic (str, default: '') – A String specifying the region being monitored for fully Plastic behavior. The default value is an empty string.

  • noStop (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed has been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set noStop = ON only in special cases when you have a thorough understanding of how to interpret the results.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • useLongTermSolution (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying wether to obtain the fully relaxed long-term elastic solution with time-domain viscoelasticity or the long-term elastic-Plastic solution for two-layer viscoplasticity. The default value is OFF.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the technique used to for solving nonlinear equations. Possible values are FULL_NEWTON and QUASI_NEWTON. The default value is FULL_NEWTON.

  • reformKernel (int, default: 8) – An Int specifying the number of quasi-Newton iterations allowed before the kernel matrix is reformed.. The default value is 8.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

  • adaptiveDampingRatio (float, default: 0) – A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

  • continueDampingFactors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step – A StaticRiksStep object.

Return type:

StaticRiksStep

SteadyStateDirectStep(name, previous, frequencyRange, description='', factorization=abaqusConstants.COMPLEX, scale=abaqusConstants.LOGARITHMIC, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False, subdivideUsingEigenfrequencies=OFF, frictionDamping=OFF)[source]

This method creates a SteadyStateDirectStep object.

Note

This function can be accessed by:

mdb.models[name].SteadyStateDirectStep

Note

Check SteadyStateDirectStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • frequencyRange (List[SteadyStateDirectFrequency]) – A SteadyStateDirectFrequencyArray object.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • factorization (SymbolicConstant, default: COMPLEX) – A SymbolicConstant specifying whether damping terms are to be ignored so that a real, rather than a complex, system matrix is factored. Possible values are REAL_ONLY and COMPLEX. The default value is COMPLEX.

  • scale (SymbolicConstant, default: LOGARITHMIC) – A SymbolicConstant specifying whether a logarithmic or linear scale is used for output. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • subdivideUsingEigenfrequencies (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to subdivide each frequency range using the eigenfrequencies of the system. The default value is OFF.

  • frictionDamping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

Returns:

step – A SteadyStateDirectStep object.

Return type:

SteadyStateDirectStep

SteadyStateModalStep(name, previous, frequencyRange, description='', scale=abaqusConstants.LOGARITHMIC, directDamping=None, compositeDamping=None, rayleighDamping=None, structuralDamping=None, directDampingByFrequency=None, rayleighDampingByFrequency=None, structuralDampingByFrequency=None, maintainAttributes=False, subdivideUsingEigenfrequencies=ON)[source]

This method creates a SteadyStateModalStep object.

Note

This function can be accessed by:

mdb.models[name].SteadyStateModalStep

Note

Check SteadyStateModalStep on help.3ds.com/2021.

Parameters:
Returns:

step – A SteadyStateModalStep object.

Return type:

SteadyStateModalStep

SteadyStateSubspaceStep(name, previous, frequencyRange, description='', factorization=abaqusConstants.COMPLEX, scale=abaqusConstants.LOGARITHMIC, matrixStorage=abaqusConstants.SOLVER_DEFAULT, maintainAttributes=False, subdivideUsingEigenfrequencies=ON, projection=abaqusConstants.ALL_FREQUENCIES, maxDampingChange=0, maxStiffnessChange=0, frictionDamping=OFF)[source]

This method creates a SteadyStateSubspaceStep object.

Note

This function can be accessed by:

mdb.models[name].SteadyStateSubspaceStep

Note

Check SteadyStateSubspaceStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • frequencyRange (List[SteadyStateSubspaceFrequency]) – A SteadyStateSubspaceFrequencyArray object.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • factorization (SymbolicConstant, default: COMPLEX) – A SymbolicConstant specifying whether damping terms are to be ignored so that a real, rather than a complex, system matrix is factored. Possible values are REAL_ONLY and COMPLEX. The default value is COMPLEX.

  • scale (SymbolicConstant, default: LOGARITHMIC) – A SymbolicConstant specifying whether a logarithmic or linear scale is used for output. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • subdivideUsingEigenfrequencies (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to subdivide each frequency range using the eigenfrequencies of the system. The default value is ON.

  • projection (SymbolicConstant, default: ALL_FREQUENCIES) – A SymbolicConstant specifying how often to perform subspace projections onto the modal subspace. Possible values are ALL_FREQUENCIES, CONSTANT, EIGENFREQUENCY, PROPERTY_CHANGE, and RANGE. The default value is ALL_FREQUENCIES.

  • maxDampingChange (float, default: 0) – A Float specifying the maximum relative change in damping material properties before a new projection is to be performed. The default value is 0.1.

  • maxStiffnessChange (float, default: 0) – A Float specifying the maximum relative change in stiffness material properties before a new projection is to be performed. The default value is 0.1.

  • frictionDamping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

Returns:

step – A SteadyStateSubspaceStep object.

Return type:

SteadyStateSubspaceStep

SubspaceDynamicsStep(name, previous, description='', timePeriod=1, vectors=abaqusConstants.ALL, nlgeom=OFF, maxNumInc=100, incSize=0, amplitude=abaqusConstants.STEP, maintainAttributes=False)[source]

This method creates a SubspaceDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].SubspaceDynamicsStep

Note

Check SubspaceDynamicsStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • timePeriod (float, default: 1) – A Float specifying the total time period of the step. The default value is 1.0.

  • vectors (SymbolicConstant, default: ALL) – The SymbolicConstant ALL or an Int specifying the number of modes to be used for subspace projection. The possible value for the SymbolicConstant is ALL. The default value is ALL.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • incSize (float, default: 0) – A Float specifying the suggested time increment. The default value is 0.0.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

Returns:

step – A SubspaceDynamicsStep object.

Return type:

SubspaceDynamicsStep

SubstructureGenerateStep(name, previous, substructureIdentifier, description='', recoveryMatrix=abaqusConstants.WHOLE_MODEL, recoveryRegion=None, computeGravityLoadVectors=False, computeReducedMassMatrix=False, computeReducedStructuralDampingMatrix=False, computeReducedViscousDampingMatrix=False, evaluateFrequencyDependentProperties=False, frequency=0, retainedEigenmodesMethod=abaqusConstants.NONE, modeRange=None, frequencyRange=None, globalDampingField=abaqusConstants.NONE, alphaDampingRatio=0, betaDampingRatio=0, structuralDampingRatio=0, viscousDampingControl=abaqusConstants.NONE, structuralDampingControl=abaqusConstants.NONE)[source]

This method creates a SubstructureGenerateStep object.

Note

This function can be accessed by:

mdb.models[name].SubstructureGenerateStep

Note

Check SubstructureGenerateStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • substructureIdentifier (int) – An Integer specifying a unique identifier for the substructure.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • recoveryMatrix (SymbolicConstant, default: WHOLE_MODEL) – A SymbolicConstant specifying the subtructure recovery to be computed. Possible values are WHOLE_MODEL, REGION, and NONE. The default value is WHOLE_MODEL.

  • recoveryRegion (Optional[Region], default: None) – A Region object specifying the region for substructure recovery. This argument is required when recoveryMatrix = REGION.

  • computeGravityLoadVectors (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to compute the gravity load vectors. The default value is False.

  • computeReducedMassMatrix (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to compute the reduced mass matrix. The default value is False.

  • computeReducedStructuralDampingMatrix (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to compute the reduced structural damping matrix. The default value is False.

  • computeReducedViscousDampingMatrix (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to compute the reduced viscous damping matrix. The default value is False.

  • evaluateFrequencyDependentProperties (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to evaluate the frequency dependent properties. The default value is False.

  • frequency (float, default: 0) – A Float specifying the frequency at which to evaluate the frequency dependent properties. The default value is 0.0.

  • retainedEigenmodesMethod (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the eigenmodes to be retained. Possible values are MODE_RANGE, FREQUENCY_RANGE, and NONE. The default value is NONE.

  • modeRange (Optional[List[SubstructureGenerateModes]], default: None) – A SubstructureGenerateModesArray object.

  • frequencyRange (Optional[List[SubstructureGenerateFrequency]], default: None) – A SubstructureGenerateFrequencyArray object.

  • globalDampingField (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the field to which the global damping factors should be applied. Possible values are ALL, ACOUSTIC, MECHANICAL, and NONE. The default value is NONE.

  • alphaDampingRatio (float, default: 0) – A Float specifying the factor to create global Rayleigh mass proportional damping. The default value is 0.0.

  • betaDampingRatio (float, default: 0) – A Float specifying the factor to create global Rayleigh stiffness proportional damping. The default value is 0.0.

  • structuralDampingRatio (float, default: 0) – A Float specifying the factor to create frequency-independent stiffness proportional structural damping. The default value is 0.0.

  • viscousDampingControl (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the damping control to include the viscous damping matrix. Possible values are ELEMENT, FACTOR, COMBINED, and NONE. The default value is NONE.

  • structuralDampingControl (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the damping control to include the structural damping matrix. Possible values are ELEMENT, FACTOR, COMBINED, and NONE. The default value is NONE.

Returns:

step – A SubstructureGenerateStep object.

Return type:

SubstructureGenerateStep

TempDisplacementDynamicsStep(name, previous, description='', timePeriod=1, nlgeom=OFF, timeIncrementationMethod=abaqusConstants.AUTOMATIC_GLOBAL, maxIncrement=None, scaleFactor=1, userDefinedInc=None, massScaling=abaqusConstants.PREVIOUS_STEP, linearBulkViscosity=0, quadBulkViscosity=1, maintainAttributes=False, improvedDtMethod=ON)[source]

This method creates a TempDisplacementDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].TempDisplacementDynamicsStep

Note

Check TempDisplacementDynamicsStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • timePeriod (float, default: 1) – A Float specifying the time period of the step. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC_GLOBAL) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are AUTOMATIC_GLOBAL, AUTOMATIC_EBE, FIXED_USER_DEFINED_INC, and FIXED_EBE. The default value is AUTOMATIC_GLOBAL.

  • maxIncrement (Optional[float], default: None) – None or a Float specifying the maximum time increment allowed. If there is no upper limit, maxIncrement = None. The default value is None.

  • scaleFactor (float, default: 1) – A Float specifying the factor that is used to scale the time increment. This argument is required only when timeIncrementationMethod = AUTOMATIC_GLOBAL, AUTOMATIC_EBE, or FIXED_EBE. The default value is 1.0.

  • userDefinedInc (Optional[float], default: None) – None or a Float specifying the user-defined time increment. The default value is None.

  • massScaling (List[MassScaling], default: PREVIOUS_STEP) – A MassScalingArray object specifying mass scaling controls. The default value is PREVIOUS_STEP.

  • linearBulkViscosity (float, default: 0) – A Float specifying the linear bulk viscosity parameter, b1b1. The default value is 0.06.

  • quadBulkViscosity (float, default: 1) – A Float specifying the quadratic bulk viscosity parameter, b2b2. The default value is 1.2.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • improvedDtMethod (Union[AbaqusBoolean, bool], default: ON) –

    A Boolean specifying whether to use the “improved” (improvedDtMethod = ON) or “conservative” (improvedDtMethod = OFF) method to estimate the element stable time increment for three-dimensional continuum elements and elements with plane stress formulations (shell, membrane, and two-dimensional plane stress elements). The default value is ON.

    New in version 2018: The improvedDtMethod argument was added.

Returns:

step – A TempDisplacementDynamicsStep object.

Return type:

TempDisplacementDynamicsStep

ViscoStep(name, previous, description='', timePeriod=1, nlgeom=OFF, stabilizationMethod=abaqusConstants.NONE, stabilizationMagnitude=None, timeIncrementationMethod=abaqusConstants.AUTOMATIC, matrixSolver=abaqusConstants.DIRECT, matrixStorage=abaqusConstants.SOLVER_DEFAULT, initialInc=None, maxNumInc=100, minInc=None, maxInc=1, integration=abaqusConstants.IMPLICIT_EXPLICIT, cetol=0, amplitude=abaqusConstants.STEP, extrapolation=abaqusConstants.LINEAR, maintainAttributes=False, solutionTechnique=abaqusConstants.FULL_NEWTON, reformKernel=8, convertSDI=abaqusConstants.PROPAGATED, adaptiveDampingRatio=0, continueDampingFactors=OFF)[source]

This method creates a ViscoStep object.

Note

This function can be accessed by:

mdb.models[name].ViscoStep

Note

Check ViscoStep on help.3ds.com/2021.

Parameters:

  • name (str) – A String specifying the repository key.

  • previous (str) – A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

  • description (str, default: '') – A String specifying a description of the new step. The default value is an empty string.

  • timePeriod (float, default: 1) – A Float specifying the total time period. The default value is 1.0.

  • nlgeom (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.

  • stabilizationMethod (SymbolicConstant, default: NONE) – A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

  • stabilizationMagnitude (Optional[float], default: None) – A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10-4.

  • timeIncrementationMethod (SymbolicConstant, default: AUTOMATIC) – A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

  • matrixSolver (SymbolicConstant, default: DIRECT) – A SymbolicConstant specifying the type of solver. Possible values are DIRECT and ITERATIVE. The default value is DIRECT.

  • matrixStorage (SymbolicConstant, default: SOLVER_DEFAULT) – A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

  • initialInc (Optional[float], default: None) – A Float specifying the initial time increment. The default value is the total time period for the step.

  • maxNumInc (int, default: 100) – An Int specifying the maximum number of increments in a step. The default value is 100.

  • minInc (Optional[float], default: None) – A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10−5 times the total time period.

  • maxInc (float, default: 1) – A Float specifying the maximum time increment allowed. The default is the total time period for the step. The default value is 1.0.

  • integration (SymbolicConstant, default: IMPLICIT_EXPLICIT) – A SymbolicConstant specifying which type of integration to use throughout the step. Possible values are IMPLICIT_EXPLICIT and EXPLICIT_ONLY. The default value is IMPLICIT_EXPLICIT.

  • cetol (float, default: 0) – A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

  • amplitude (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.

  • extrapolation (SymbolicConstant, default: LINEAR) – A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

  • maintainAttributes (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

  • solutionTechnique (SymbolicConstant, default: FULL_NEWTON) – A SymbolicConstant specifying the technique used to for solving nonlinear equations. Possible values are FULL_NEWTON and QUASI_NEWTON. The default value is FULL_NEWTON.

  • reformKernel (int, default: 8) – An Int specifying the number of quasi-Newton iterations allowed before the kernel matrix is reformed.. The default value is 8.

  • convertSDI (SymbolicConstant, default: PROPAGATED) – A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

  • adaptiveDampingRatio (float, default: 0) – A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

  • continueDampingFactors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step – A ViscoStep object.

Return type:

ViscoStep

absoluteZero: Optional[float] = None[source]

None or a Float specifying the absolute zero constant. The default value is None.

adaptiveMeshConstraints: Dict[str, AdaptiveMeshConstraint] = {}[source]

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls: Dict[str, AdaptiveMeshControl] = {}[source]

A repository of AdaptiveMeshControl objects.

amplitudes: Dict[str, Amplitude] = {}[source]

A repository of Amplitude objects.

analyticalFields: Dict[str, AnalyticalField] = {}[source]

A repository of AnalyticalField objects.

boundaryConditions: Dict[str, BoundaryCondition] = {}[source]

A repository of BoundaryCondition objects.

calibrations: Dict[str, Calibration] = {}[source]

A repository of Calibration objects.

constraints: Dict[str, Constraint] = {}[source]

A repository of ConstrainedSketchConstraint objects.

contactControls: Dict[str, ContactControl] = {}[source]

A repository of ContactControl objects.

contactInitializations: Dict[str, ContactInitialization] = {}[source]

A repository of ContactInitialization objects.

contactStabilizations: Dict[str, ContactStabilization] = {}[source]

A repository of ContactStabilization objects.

copyConnectors: Boolean = OFF[source]

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyConstraints: Boolean = OFF[source]

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyInteractions: Boolean = OFF[source]

A boolean specifying the status of interactions created in a model, in the model which instances this model.

description: str = ''[source]

A String specifying the purpose and contents of the Model object. The default value is an empty string.

discreteFields: Dict[str, DiscreteField] = {}[source]

A repository of DiscreteField objects.

endRestartStep: Boolean = OFF[source]

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

eventSeriesDatas: Dict[str, EventSeriesData] = {}[source]

A repository of EventSeriesData objects.

New in version 2020: The eventSeriesDatas attribute was added.

eventSeriesTypes: Dict[str, EventSeriesType] = {}[source]

A repository of EventSeriesType objects.

New in version 2020: The eventSeriesTypes attribute was added.

featureOptions: FeatureOptions = <abaqus.Feature.FeatureOptions.FeatureOptions object>[source]

A FeatureOptions object.

fieldOutputRequests: Dict[str, FieldOutputRequest] = {'F-Output-1': <abaqus.StepOutput.FieldOutputRequest.FieldOutputRequest object>}[source]

A repository of FieldOutputRequest objects.

filters: Dict[str, Filter] = {}[source]

A repository of Filter objects.

globalJob: str = ''[source]

A String specifying the name of the job that generated the results for the global model.

historyOutputRequests: Dict[str, HistoryOutputRequest] = {}[source]

A repository of HistoryOutputRequest objects.

integratedOutputSections: Dict[str, IntegratedOutputSection] = {}[source]

A repository of IntegratedOutputSection objects.

interactionProperties: Dict[str, ContactProperty] = {}[source]

A repository of InteractionProperty objects.

interactions: Dict[str, Interaction] = {}[source]

A repository of Interaction objects.

keywordBlock: KeywordBlock = <abaqus.Model.KeywordBlock.KeywordBlock object>[source]

A KeywordBlock object.

lastChangedCount: Optional[float] = None[source]

A Float specifying the time stamp that indicates when the model was last changed.

linkedInstances: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts: tuple = ()[source]

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads: Dict[str, Load] = {}[source]

A repository of Load objects.

materials: Dict[str, Material] = {}[source]

A repository of Material objects.

name: str = ''[source]

A String specifying the repository key.

noPartsInputFile: Boolean = OFF[source]

A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

optimizationTasks: Dict[str, OptimizationTask] = {}[source]

A repository of OptimizationTask objects.

parts: Dict[str, Part] = {}[source]

A repository of Part objects.

predefinedFields: Dict[str, PredefinedField] = {}[source]

A repository of PredefinedField objects.

profiles: Dict[str, Profile] = {}[source]

A repository of Profile objects.

remeshingRules: Dict[str, RemeshingRule] = {}[source]

A repository of RemeshingRule objects.

restartIncrement: Optional[SymbolicConstant] = None[source]

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

restartJob: str = ''[source]

A String specifying the name of the job that generated the restart data.

restartStep: str = ''[source]

A String specifying the name of the step where the restart analysis will start.

rootAssembly: Assembly = <abaqus.Assembly.Assembly.Assembly object>[source]

An Assembly object.

sections: Dict[str, Section] = {}[source]

A repository of Section objects.

setValues(description='', noPartsInputFile=OFF, absoluteZero=None, stefanBoltzmann=None, waveFormulation=abaqusConstants.NOT_SET, universalGas=None, restartJob='', restartStep='', restartIncrement=None, endRestartStep=OFF, globalJob='', shellToSolid=OFF, copyConstraints=OFF, copyConnectors=OFF, copyInteractions=OFF)[source]

This method modifies the Model object.

Note

Check Model.setValues on help.3ds.com/2021.

Parameters:

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • noPartsInputFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether an input file should be written without parts and assemblies. The default value is OFF.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • waveFormulation (SymbolicConstant, default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • restartJob (str, default: '') – A String specifying the name of the job that generated the restart data.

  • restartStep (str, default: '') – A String specifying the name of the step where the restart analysis will start.

  • restartIncrement (Optional[SymbolicConstant], default: None) – An Int specifying the increment, interval, iteration or cycle where the restart analysis will start. To select the end of the step use the SymbolicConstant STEP_END.

  • endRestartStep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

  • globalJob (str, default: '') – A String specifying the name of the job that generated the results for the global model.

  • shellToSolid (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying that a shell global model drives a solid submodel.

  • copyConstraints (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the constraints created in the model to the model that instances this model.

  • copyConnectors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the connectors created in the model to the model that instances this model

  • copyInteractions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to copy the interactions created in the model to the model that instances this model.

shellToSolid: Boolean = OFF[source]

A Boolean specifying that a shell global model drives a solid submodel.

sketches: Dict[str, ConstrainedSketch] = {}[source]

A repository of ConstrainedSketch objects.

stefanBoltzmann: Optional[float] = None[source]

None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

steps: Dict[str, Step] = {'Initial': <abaqus.Step.InitialStep.InitialStep object>}[source]

A repository of Step objects.

tableCollections: Dict[str, TableCollection] = {}[source]

A repository of TableCollection objects.

New in version 2020: The tableCollections attribute was added.

timePoints: Dict[str, TimePoint] = {}[source]

A repository of TimePoint objects.

universalGas: Optional[float] = None[source]

None or a Float specifying the universal gas constant. The default value is None.

waveFormulation: SymbolicConstant = NOT_SET[source]

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

KeywordBlock#

class KeywordBlock[source]#

The KeywordBlock object contains a representation of its model in the Abaqus input file format. You may edit the contents of the KeywordBlock to add solver functionality that is not supported by Abaqus/CAE. As a general rule, edits to the KeywordBlock object should be made as the last step prior to writing the actual Abaqus input file, thus avoiding possible conflicts with changes made using other MDB commands. The KeywordBlock object has no constructor. A KeywordBlock object is created when you create a model object. A model object contains only one KeywordBlock object.

Note

This object can be accessed by:

mdb.models[name].keywordBlock

Note

Check KeywordBlock on help.3ds.com/2021.

edited: Union[AbaqusBoolean, bool] = OFF[source]#

A Boolean specifying whether the Keywords Editor has been used to change the model.

insert(position, text)[source]#

This method inserts a String at a specified position in the sieBlocks member.

Note

Check KeywordBlock.insert on help.3ds.com/2021.

Parameters:

  • position (int) – An Int specifying the position in the sieBlocks member after which the new string will be inserted.

  • text (str) – A String specifying the text to be inserted. The text represents an Abaqus input file keyword and its associated data

Raises:

IndexError –

lastSynchCount: Optional[float] = None[source]#

A Float specifying the value of the counter associated with the Mdb object at the most recent synchronization.

replace(position, text)[source]#

This method replaces a String at a specified position in the sieBlocks member.

Note

Check KeywordBlock.replace on help.3ds.com/2021.

Parameters:

  • position (int) – An Int specifying the position of the String to be replaced in the sieBlocks member.

  • text (str) – A String specifying the text to be replaced. The text represents an Abaqus input file keyword and its associated data.

Raises:

IndexError –

setValues(edited=OFF)[source]#

This method modifies the KeywordBlock object.

Note

Check KeywordBlock.setValues on help.3ds.com/2021.

Parameters:

edited (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether this objects sieBlocks member has been edited. Setting edited=False will set the sieBlocks member to an empty tuple, thereby discarding all previous edits.

sieBlocks: tuple = ()[source]#

A tuple of Strings specifying a sequence of Strings that is identical to the information written to the Abaqus input file. Each String in the sequence represents an Abaqus input file keyword along with the parameters and data lines associated with the keyword. A String can also be a comment in the input file. You initialize this data member by calling synchVersions. After you initialize the data member, you use calls to replace and insert to record your edits in the correct location. If the last call to synchVersions used the argument storeNodesAndElements = False, the entry for the keywords NODE and ELEMENT will contain only the keyword and its parameters, not the data lines.

synchVersions(storeNodesAndElements)[source]#

This method synchronizes, or merges, the edits made in this object with those made in the model using other scripting commands or the user interface. The synchVersions method updates the sieBlocks member. The sieBlocks member is empty prior to the first call to synchVersions. As a side effect, synchVersions sets lastSynchCount to the current value of the counter associated with the Mdb object, which is used to determine if synchronization is necessary.

Note

Check KeywordBlock.synchVersions on help.3ds.com/2021.

Parameters:

storeNodesAndElements (Union[AbaqusBoolean, bool]) – A Boolean specifying whether the nodal coordinates and element connectivities (i.e. the data lines for the NODE and *ELEMENT keyword blocks) are to be stored in the **sieBlocks* member. All other keywords and their data lines are always stored. The default value is True. If storeNodesAndElements is True, the size of the keywordBlock data will be similar to that of the input file. Since the KeywordBlock is stored in the Abaqus/CAE database, this will result in a larger database. It will also result in a slower execution of the synchVersions command. If storeNodesAndElements is False, the data lines are not stored in sieBlocks. Consequently, only set storeNodesAndElements = True if you wish to make changes to the NODE or ELEMENT data lines themselves. If your task is limited to reading nodal coordinates and element connectivities (i.e. not editing this information) then it is generally better to access this information from other parts of the Mdb.

Raises:

IndexError –